You are on page 1of 55

Comunicao Tcnica

Departamento de Engenharia Informtica, FCTUC, 2008/2009

Escrita Tcnica:
aspectos bsicos
Henrique Madeira
Henrique Madeira, DEI-FCTUC, 2006

Faculdade de Cincias e Tecnologia da Universidade de Coimbra 2008/2008


Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Departamento de Engenharia Informtica

1 1

Plano para o mdulo de escrita de artigos cientficos


Comunicao escrita: aspectos bsicos
Aspectos bsicos do processo de escrita Tipos de escrita (argumentativa, descritiva, narrativa,...) Reviso de documentos

Escrita de artigos cientficos Reviso de artigos cientficos


Henrique Madeira, DEI-FCTUC, 2006

Apresentao oral de artigos cientficos

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Bibliografia
Apontamentos fornecidos pelos docentes para apoio s aulas Livros:
FAST, Julius, A linguagem do corpo, Lisboa, Edies 70, 1986. NETO, Paula, Tcnicas de falar para grupos, Lisboa, Prefcio Editores, 2003. WESTON, Anthony, A arte de argumentar, 2. ed., Lisboa, Gradiva, 1996 Heres how to write well, Elizabeth McMahan and Robert Funk, Longman Pub., 2002. A Arte de Argumentar, A. Weston, Lisboa: Gradiva, 145 pp., 1996. The Classic Guide to Better Writing, Rudolf Flesch, Harper Collins Pub., 1996. Writing Prose: Techniques and Purposes, Oxford University Press, 1986.

H muito material na Internet referente a tcnicas de escrita, embora seja normalmente para escrita em ingls.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Planificao: aulas e palestras


Aula 1 (10 Out.) Introduo (Amlcar) Aula 2 (17 Out.) Mtodos Quantitativos (Paquete) Aula 3 (31 Out.) Mtodos Quantitativos (Paquete) Aula 4 (7 Nov) Escrita de Artigos Cientficos (Henrique) Aula 5 (14 Nov.) Escrita de Artigos Cientficos (Henrique) Aula 6 (21 Nov.) Escrita de Artigos Cientficos (Henrique) Aula 7, 28 Nov: Quantitative Research Methods (Paquete) Aula 8 (5 Dez.) Quantitative Research Methods (Paquete) Aula 9 (12 Dez.) Apresentao de Artigos Cientficos (Henrique) Doctoral Consortium Aula 10 (22 Jan.) Sesso de treino para as apresentaes (Henrique) Aula 11 (23 Jan.) Workshop Doctoral Consortium - avaliao de apresentaes (com todos os docentes + orientadores de alunos) Palestras Palestra 1 (? Jan.) Qualitative research topics (data a definir) Palestra 2 (? Jan.) Research Methods, Roy maxion, CMU, USA (data a definir)
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Planificao: escrita e apresentao de artigos cientficos


Aula 4, 7 Nov: Escrita de Artigos Cientficos (Henrique)
o Aspectos bsicos de escrita o Modos de escrita o Anlise de exemplos

Aula 5, 14 Nov: Escrita de Artigos Cientficos (Henrique)


o Reviso de textos o Prtica de reviso de textos (2 hora; precisa de computador) o Escrita de artigos cientficos o Pratica de escrita de artigos cientficos (2 hora; precisa de computador)
Henrique Madeira, DEI-FCTUC, 2006

Aula 6, 21 Nov: Escrita de Artigos Cientficos (Henrique)

Aula 9, 12 Dez: Apresentao de Artigos Cientficos (Henrique)


o Organizao da apresentao, tempo, materiais (slides), voz, movimento, gestos, contacto visual, estilo, humor, perguntas & respostas, concluses
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Avaliao: escrita e apresentao de artigos


Avaliao
Textos Oficina de escrita Artigo escrito para o mdulo de Mtodos Quantitativos (2 alunos) Reviso de artigo escrito para o mdulo de Mtodos Quantitativos Escrita de artigo

Valores
5% 5% 5% 15% 10%

Apresentao de artigo
Total

40
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

The research business


(my personal view)
Identification of research problems (the key issue) Relevance of the research New/different is not enough Proving/showing that your proposal is better. The research approach (the experimental view) The Pygmalion effect Convincing the other researchers and the world
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Aspectos bsicos do processo de escrita


Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

primeira passagem pelos conceitos bsicos e estratgias


Aspectos bsicos
O processo de escrita Como abordar os leitores Estruturao de textos

Curso de escrita:

Estratgias de escrita
Persuasiva Narrativa Descritiva Expositiva Definio Comparativa Descrio de processos
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

No h segredos apenas bons conselhos


Prever tempo suficiente para a escrita: demora pelo menos o dobro do
tempo que se espera partida .

A escrita merece tempo: o que se escreve marca de forma indelvel a


qualidade do nosso trabalho.

Rever cuidadosamente: nunca, nunca, nunca dar um texto por terminado sem o
rever cuidadosamente. Nem sequer um simples e-mail
Henrique Madeira, DEI-FCTUC, 2006

Escrever bem uma atitude. No algo que se faz ocasionalmente quando se acha que as circunstncias ou os nossos leitores o merecem.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

10

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

O mais importante: saber ler o que escrevemos


Ciclo curto
Escrever uma frase L-la. Est clara? o que queremos dizer? Rever imediatamente.

Ciclo longo
Henrique Madeira, DEI-FCTUC, 2006

Parar de escrever por um momento e comear a ler alguns pargrafos atrs do ponto em que se parou. As frases esto bem encadeadas? Como est a ligao entre pargrafos? Rever.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

11

Pensar antes de escrever


Objectivo: por que razo estou a escrever? Leitores: para quem escrevo? Ponto principal: o que quero dizer?

Escrever registar os nossos pensamentos de forma clara e convincente. Nunca esquecer qual o objectivo, quem so os leitores e o que se quer efectivamente dizer durante todo o processo de escrita e de reviso dos textos. Instanciar estas perguntas a todos os nveis do documento: captulos, seces, subseces, pargrafos.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

12

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Pensar no objectivo
O que se pretende com o texto?
Fornecer informao? Descrever um processo? Persuadir os leitores?

O objectivo a atingir determina largamente a forma como se organiza o texto:


Henrique Madeira, DEI-FCTUC, 2006

A maneira como se comea. Como se organiza a informao. As palavras utilizadas. O tom usado.

Determinar antecipadamente o objectivo a atingir com o texto e manter esse objectivo em mente enquanto planeia e escreve texto. Rever o texto procurando verificar se o objectivo realmente atingido.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

13

Nunca esquecer a audincia


Caracterizar os leitores (e o que estes esperam)
Uma pessoa em particular? Um grupo homogneo? Um grupo heterogneo? Qual o grupo primrio? Um grupo indiferenciado?

A audincia determina fortemente o texto


Henrique Madeira, DEI-FCTUC, 2006

Contexto e enquadramento. Material a apresentar. Tom e palavras a usar.

No perder os leitores de vista enquanto se selecciona o material a apresentar, o tom e as palavras certas. No esquecer de pensar nos leitores enquanto se rev o texto.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

14

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Encontrar o foco
Identificar a tese: qual a ideia principal e qual a abordagem certa para a
apresentar? Mas preciso no esquecer o objectivo e a audincia enquanto se define o ponto (tese) principal do texto.

Desenvolver a tese como parte do processo de escrita: afunilar,


expandir ou ajustar o foco sempre que necessrio.

Repetir a procura da tese enquanto se define a estrutura do texto. Identificar a tese de cada captulo, seco ou mesmo o ponto principal de cada pargrafo.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

15

Voltar a pensar nos leitores


Uma vez definido o objectivo do texto e o assunto principal (tese) importante voltar a pensar na audincia esperada: O que que os leitores sabem sobre o assunto principal: nada, pouco, muito, no se sabe bem? Qual a posio dos leitores perante o assunto do texto: entusisticos, hostis, neutrais, no se sabe ao certo? Identificar caractersticas da audincia que possam influenciar a maneira como vo ler o texto: faixa etria, sexo, nvel cultural, estrato socioeconmico, valores morais, ideais polticos, etc.?
Isto determina a maneira como o texto se dirige aos leitores: formal, informal, familiar, sria, bem humorada, defensiva, interessada, confiante, cnica, irritada, etc.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira
Henrique Madeira, DEI-FCTUC, 2006

16

Henrique Madeira, DEI-FCTUC, 2006

Escrever a tese numa nica frase antes de fazer qualquer rascunho do texto.

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Desenvolver os detalhes
Fazer uma lista de ideias relevantes, factos, etc Tentar organizar as ideias em grupos. Recolher textos que possam ser teis como referncia ou enquadramento.
Henrique Madeira, DEI-FCTUC, 2006

Comear a tentar definir a estrutura do texto


A estruturao de um texto um processo de tentativa e erro. Mas a primeira pessoa a descobrir os erros de estruturao o prprio autor, o que nem sempre fcil.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

17

Estruturao de textos
Qual a melhor estrutura para expor as ideias e argumentos que definem e defendem a tese do texto?
Um dos problemas mais difceis na escrita

Estrutura do texto:
Ajuda a organizar as ideias. Apresenta o material de uma forma lgica. Mostra as relaes entre os assuntos. Ajuda a construir uma viso ordenada do assunto do texto. Delimita os assuntos.

Manter uma atitude cptica sobre a estrutura previamente definida enquanto se escreve e rev. Ajustar a estrutura sempre que necessrio.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

18

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Princpios para correcta estruturao de textos


Coordenao: decompor o documento de uma forma coerente e consistente. Subordinao: estruturar do geral para o particular, do abstracto para o concreto, etc. Diviso: dividir cada seco em duas ou mais subseces sem sobreposies. Granularidade: definir o nvel de granularidade certo e manter a consistncia.
Sempre que for necessrio alterar o nvel de granularidade numa dada zona do texto, tal deve ter uma justificao evidente aos olhos do leitor.

Forma e estilo: estruturar o texto por tpicos ou frases e ser consistente.


A regra mais importante para a estruturao de textos: ser consistente!
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

19

Estruturao: coordenao
Coordenao incorrecta
1. 2. 3. Licenciatura em Engenharia Informtica Disciplina de Comunicao Tcnica Mestrado em Engenharia Informtica

Coordenao correcta (ex. 1)


1. 2. 3. Licenciatura em Engenharia Informtica Mestrado em Engenharia Informtica Doutoramento em Engenharia Informtica

Coordenao correcta (ex. 2)


1. Licenciatura em Engenharia Informtica
1.1 Estrutura curricular
1.1.1 Modelo e durao 1.1.2 reas cientficas
Henrique Madeira, DEI-FCTUC, 2006

1.2 Disciplinas
1.2.1 Anlise 1.2.2 Tecnologia de Computadores

2.

Mestrado em Engenharia Informtica

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

20

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

10

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Estruturao: subordinao
Subordinao incorrecta
1. Sistemas operativos
1.1 Linux 1.2 Windows 1.3 Obsoletos 1.4 Cdigo aberto 1.5 Baixo custo

Subordinao correcta
1. Sistemas operativos
1.1 Linux 1.1.1 Aspectos positivos 1.1.2 Aspectos negativos 1.2 Windows 1.2.1 Aspectos positivos 1.2.2 Aspectos negativos

Apesar de correcta do ponto de vista de subordinao, esta no uma boa estrutura. Porqu?
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

21

Estruturao: diviso
Diviso incorrecta
1. 3. Falhas de hardware
1.1 Caractersticas temporais das falhas

Diviso correcta
1. Tipos de falhas
1.1 Hardware 1.1.1 Falhas transitrias 1.1.2 Falhas permanentes 1.2 Software 1.2.1 Requisitos 1.2.2 Concepo 1.2.3 Codificao

Falhas de software
2.1 Fase de desenvolvimento do software

3. Tcnicas de tolerncia a falhas


3.1 3.2 3.3 3.3 TMR Tcnicas estruturais Sobresselente a quente Tcnicas comportamentais

2. Tcnicas de tolerncia a falhas


2.1 Estruturais 2.1.1 TMR 2.1.2 Sobresselente a quente 2.2 Comportamentais

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

22

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

11

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Estruturao: granularidade
Trs nveis de granularidade (ex.)
1. Tipos de falhas
1.1 Hardware 1.1.1 Falhas transitrias 1.1.2 Falhas permanentes 1.2 Software 1.2.1 Requisitos 1.2.2 Concepo 1.2.3 Codificao

No ir alm dos dois nveis no primeiro esboo da estrutura. Evitar ter mais de trs nveis de subseces. Nunca ir alm de quatro nveis. A granularidade deve ser consistente e evidente.

2. Tcnicas de tolerncia a falhas


2.1 Estruturais 2.1.1 TMR 2.1.2 Sobresselente a quente 2.2 Comportamentais

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

23

Estruturao: forma e estilo


Usar estruturao por tpicos ou por frases, conforme for o mais adequado. Ser consistente.
Topicos
1. Estratgias de escrita
1.1 Narrao 1.2 Descrio 1.3 Persuaso 1.4 .

Frases
1. Estratgias para os diferentes tipos de escrita
Henrique Madeira, DEI-FCTUC, 2006

1.1 Escrita de narrativas 1.2 Escrita descritiva 1.3 Escrita persuasiva 1.4 .

2. Reviso
2.1 De cima para baixo 2.2 Estilo 2.3

2. Reviso dos seus prprios textos


2.1 Reviso de cima para baixo 2.2 Reviso do estilo 2.3

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

24

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

12

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Rever principais perguntas antes de escrever


Perguntas:
1. 2. 3. 4. 5. Qual o meu ponto principal? Quem so os meus leitores primordiais? Qual o meu objectivo relativamente a esses leitores? Que factos, evidncias, ideias, resultados, etc vou usar no texto? Como vou organizar o texto de forma a que os leitores possam entender e aceitar facilmente as minhas ideias e argumentos?
Henrique Madeira, DEI-FCTUC, 2006

Aces:
1. 2. 3. 4. 5. Encontrar um ttulo (mesmo que no seja o definitivo) Definir um primeiro esboo da estrutura Usar pontos (bullets) para coligir as ideias principais em cada seco e subseco. Estimar o espao necessrio para cada seco. Comear a escrever o primeiro rascunho!

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

25

(trata-se de um exemplo real de um artigo escrito em ingls)


How to Specify and Validate Dependability Benchmarks for OLTP Application Environments 1. Introduction (2 pages)
- The need and relevance of dependability benchmarks - The problem of validating a measuring tool (a benchmark) - Paper contribution and structure

Examplo: estrutura de um artigo cientfico

O ttulo deve incluir a tese ou ponto principal

2. Related work (1.5 pages)


- Dependability evaluation approaches - Performance benchmarking - Previous dependability benchmark proposals

3. Components and properties of a dependability benchmark (2.5 pages)


- Key benchmark components - Properties and their relevance for the validation process

4. Validation approach (3 pages)


- Describe proposed approach - Feasibility analysis

5. Experimental results (5 pages)


5.1 Summary of DBench-OLTP dependability benchmark 5.2 Systems under benchmarking Isto uma estrutura de artigo cientfico muito clssica. Normalmente arriscado inovar na estruturao quando os leitores esperam uma 5.3 Results and properties validation estrutura familiar ou cannica. 6. Conclusions (0.5 pages)
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

26

Henrique Madeira, DEI-FCTUC, 2006

Estimar, mesmo que grosseiramente, o espao necessrio para cada seco.

Henrique Madeira

13

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Uma boa introduo


Capta a ateno do leitor. Deixa claro o que os leitores devem esperar do resto do texto. Fornece algum enquadramento do assunto. Desenvolve o interesse pelo assunto do texto. Guia o leitor para a tese ou ponto principal. Motiva e convence os leitores acerca da relevncia da tese. Explica porque que o texto nico, novo, interessante, que vale a pena ler, etc. Termina normalmente descrevendo a estrutura do resto do documento.
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

27

Alguns mitos e erros comuns na escrita de introdues


A introduo deve ser escrita no fim, depois de todo o documento ter sido escrito:
uma pssima prtica em geral (poder eventualmente ser aceitvel em documentos muito grandes). Escrever um primeiro rascunho da introduo essencial para definir o foco de todo o texto.

Comear com uma anedota ou pequena histria. Usar citaes provocativas ou questionveis. Fazer perguntas provocativas ou tendenciosas. Relatar um facto invulgar ou bizarro. .

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

28

Henrique Madeira, DEI-FCTUC, 2006

Evitar maneiras arriscadas de captar a ateno do leitor (a no ser quando o autor tem grande experincia de escrita e conhece os leitores muito bem). Exemplos:

Henrique Madeira

14

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Abordar os leitores
Encontrar a voz certa
Escrever numa voz natural normalmente a melhor escolha. Evitar vozes postias: acadmica (se no acadmico), literria (se no um literato), burocrtica, tcnica (se no for o esperado), etc.

Se for necessrio dirigir-se ao leitor directamente garantir que tal feito na pessoa apropriada. Falhas no uso da pessoa certa podem ter efeitos devastadores
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

29

Encontrar o tom certo


O tom representa a atitude que o autor imprime perante o assunto ou os leitores.
E.g., formal, srio, familiar, bem humorado, defensivo, interessado, confiante, hesitante, cnico, irritado, agressivo, suplicante, lamechas, carinhoso, atencioso, deferente, cerimonioso, oficial, entediado, cptico, crente, excitado, etc, etc, etc.

A escrita tem sempre um tom, independentemente de o autor ter conscincia disso ou controlar o tom.
Henrique Madeira, DEI-FCTUC, 2006

extremamente importante decidir e conseguir dar o tom certo de forma consciente

O tom deve reflectir o que o autor julga serem os interesses, necessidade e contexto dos leitores.
Imprimir o tom certo a um texto requer um bom entendimento das subtilezas da escrita e um grande domnio da lngua em que se escreve.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

30

Henrique Madeira, DEI-FCTUC, 2006

A utilizao da primeira pessoa nem sempre consensual em portugus (em ingls muito frequente e aconselhada). Mas evitar textos demasiado impessoais, a no ser que seja apropriado (e.g., textos cientficos, dissertaes).

Henrique Madeira

15

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplos muito simples de diferentes tons


A mesma mensagem muito simples em diferentes tons:
Empresta-me o teu carro! Hoje tarde, ok? Podes emprestar-me o teu carro hoje tarde? Pode emprestar-me o seu carro hoje tarde, por favor? Seria possvel usar o seu carro hoje tarde? Seria possvel emprestar-me o seu carro? S preciso hoje tarde. Ficar-lhe-ia eternamente grato se me pudesse emprestar o seu magnfico automvel hoje tarde.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

31

Nvel de linguagem apropriado


O tom da escrita determina trs nveis de linguagem principais (que se sobrepem frequentemente)
Escrita formal
O resultado do exame de CT foi positivo

Escrita informal
Tive positiva a CT

Escrita familiar
Henrique Madeira, DEI-FCTUC, 2006

Passei a CT

preciso usar (e dominar) o tom correctamente de modo a imprimir o nvel de linguagem correcto de forma consciente e controlada. H um grande nmero de gradaes entre o tom familiar e o formal.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

32

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

16

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Escrita formal
Usa-se quando:
O objectivo srio. O autor deseja manter uma certa distncia entre si e o leitor. Exemplos: livros, manuais tcnicos, artigos cientficos, algumas cartas de negcios, etc

Caractersticas:
Henrique Madeira, DEI-FCTUC, 2006

No se usa abreviaturas nem grias. Escrita impessoal ou na terceira pessoa. Tom srio ou neutral.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

33

Escrita informal
a escrita mais usada, mesmo em ambiente de negcios ou contextos tcnicos. Caractersticas:
Procura usar os termos mais vulgares. Admite abreviaturas. Usa a primeira pessoa. Adopta o tom mais apropriado para o objectivo e audincia.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

34

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

17

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Escrita familiar
Usa-se:
Em cartas e e-mails pessoais, dirios, etc. Quando o autor se sente prximo do leitor. Quando se tem a certeza absoluta de que os leitores entendem o contexto.

Caractersticas:
Henrique Madeira, DEI-FCTUC, 2006

Frases simplificadas e uso de abreviaturas. Grias e calo so normalmente aceitveis. Primeira e segunda pessoa. Tom normalmente ligeiro e uso frequente de humor.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

35

Outros aspectos da linguagem


Usar jargo com cuidado
Mas jargo tcnico muito habitual, mesmo em escrita formal.

Evitar palavras pretensiosas, invulgares ou expresses grandiloquentes.


Em vez de fazerem parecer as ideias mais importantes podem quebrar a completamente a comunicao.
Henrique Madeira, DEI-FCTUC, 2006

Ter cuidado com o gnero. Embora em portugus tal no constitua normalmente um problema, por vezes pode ser aconselhvel utilizar palavras neutras no que toca a gnero.
Estudante em vez de aluno ou aluna Pessoa em vez de homem ou mulher

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

36

Henrique Madeira

18

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Eufemismos
So usados normalmente para suavizar a linguagem quando se escreve sobre algo desagradvel ou com uma forte carga emotiva. Utilizar eufemismos com muito cuidado Muito eufemismos so enganadores e frequentemente ridculos aos olhos de leitores inteligentes:
Danos militares colaterais Morreram civis inocentes Crescimento econmico negativo Depresso econmica Veculo pr-usado Carro em segunda mo Habitao abaixo do standard Uma barraca

E em ingls os eufemismos podem ser to ridculos como em portugus Energetic disassembly of the plane The plane exploded A negative patient-care outcome The patient died in the hospital Adult entertainment Employee downsizing
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

37

Estrangeirismos
Evitar estrangeirismos (no original ou em adaptao) quando h boas palavras em portugus para os termos originrios de outras lnguas (ingls, normalmente).
Task force (grupo de trabalho) Partenariado (parceria) Implementar (construir, fazer, executar,)
Henrique Madeira, DEI-FCTUC, 2006

Mas quando no h nenhum termo consensual em portugus, ou a traduo pode ser ambgua, mais vale usar o termo original. As lnguas no so estticas e todos dias surgem palavras novas (oficializadas pelos dicionrios de referncia).

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

38

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

19

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Estratgias de escrita
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

39

primeira passagem pelos conceitos bsicos e estratgias


Aspectos bsicos
O processo de escrita Como abordar os leitores Estruturao de textos

Curso de escrita:

Estratgias de escrita
Persuasiva Narrativa Descritiva Expositiva Definio Comparativa Descrio de processos
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

40

Henrique Madeira

20

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Estratgias de escrita
As estratgias de escrita so mtodos tradicionalmente usados para desenvolver vrios tipos de escrita. H muitas estratgias e sub-estratgias. Na prtica, as diferentes estratgias misturam-se e combinam-se naturalmente. Mas essencial entender e dominar as principais estratgias de escrita para escrever bem.
Henrique Madeira, DEI-FCTUC, 2006

Alguns exemplos (usando verbos no infinito):


Explicar Justificar Avaliar Definir Expor Argumentar Comparar/Contrastar Sumariar Criticar Narrar Analisar Discutir Descrever Provar Informar

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

41

As estratgias de escrita principais


Narrativa: Exposio: Definio: Descrio: descrever uma experincia, acontecimento, sequncia de eventos na forma de uma pequena histria. fornecer informao ou explicar algo definir termos, objectos ou ideias. descrever uma pessoa, um lugar, objecto ou evento de forma a que o tpico possa ser visualizado pelo leitor.
Henrique Madeira, DEI-FCTUC, 2006

Comparao: mostrar as diferenas ou similitudes entre objectos, pessoas, etc. Anlise de processos: explicar os passos de um processo ou um algoritmo Persuaso: tentar influenciar a maneira como o leitor pensa ou a sua opinio sobre uma dado assunto.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

42

Henrique Madeira

21

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

primeira passagem pelos conceitos bsicos e estratgias


Aspectos bsicos
O processo de escrita Como abordar os leitores Estruturao de textos

Curso de escrita:

Tipos de escrita
Convencer pela escrita, tentando influenciar a Persuasiva maneira como o leitor pensa ou a sua opinio Comparativa sobre uma dado assunto. Descritiva Narrativa Expositiva Definio Descrio de processos
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

43

Escrita persuasiva
Uma das estratgias de escrita mais difceis (mas das mais necessrias). Quase todos os documentos necessitam de pargrafos persuasivos. Ideia base para escrever um texto persuasivo:
Henrique Madeira, DEI-FCTUC, 2006

Ter uma opinio clara e firme acerca daquilo que se pretende que o leitor aceite (o autor deve pensar bem acerca da sua prpria opinio antes de escrever). Tentar captar a ateno do leitor na primeira frase. Fornecer factos e evidncias que apoiem a sua opinio Concluir com a recapitulao do que se pretende que o leitor aceite ou acredite.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

44

Henrique Madeira

22

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Estrutura tpica de um texto persuasivo


1. Introduo
Captar a ateno do leitor Introduzir a tese, de preferncia sob a forma de uma frase curta que foca a ateno do leitor

2. Corpo
Fornecer evidncias que apoiem a tese e a opinio expressas na introduo. O corpo tem pelo menos trs pargrafos (e frequentemente tem apenas trs). Antecipar pontos de vista contrrios e tentar contra argumentar Usar estatsticas, factos, dados de investigao, experincias e exemplos da vida real que apoiem o ponto de vista do autor.

3. Concluso
Sumariar os aspectos mais importantes dos argumento e reiterar o que se pretende que o leitor acredite ou aceite.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

45

Princpios da retrica Aristotlica


Logos: Ethos: apelo baseado na razo e lgica apelo baseado no carcter/autoridade do autor ou de algum que corrobora ou apoia os ponto de vista do autor. apelo baseado na emoo.
Henrique Madeira, DEI-FCTUC, 2006

Pathos:

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

46

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

23

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de utilizao dos princpios da retrica num texto cientfico


The complete elimination of software defects during software development process is very difficult to attain in practice. In addition to well-known technical difficulties of the software development and testing process [Lyu96, Musa96], practical constraints such as the intense pressure to shrink time-tomarket and cost of software contribute to the difficulties in assuring 100% defect free software. Therefore, the current scenario in the computer industry is having systems in which software defects do exist but no one knows exactly where they are, when they will reveal themselves, and, above all, the possible consequences of the activation of the software faults. In a world where components of the shelf (COTS) are used more and more to build larger systems, the residual software faults represent a growing risk. The use of fault injection to emulate the effects of real software faults has been recognized as potentially very useful. We identify three major goals for the emulation of software faults:
Henrique Madeira, DEI-FCTUC, 2006

Ethos Pahtos

Prediction of worst case scenarios and risk assessment. The emulation of software faults can be used as a way to quantify the impact of software faults from the user point of view and get a quantitative idea of the potential risk represented by residual faults [Voas97]. Validation of fault tolerant mechanisms. As typical software faults left in deployed systems are rarely triggered, the validation of fault tolerant mechanisms can be achieved by accelerating the software fault activation through the emulation of software faults [Arlat01]. Dependability benchmarking. One recent research effort is centered on the definition of dependability benchmarks [Brown00]. Techniques to emulate software faults are essential for the benchmark faultload. From Introduction of a research paper: Henrique Madeira and Joo Dures
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

Ethos Ethos Ethos

47

Exemplo de utilizao dos princpios da retrica num texto cientfico (cont.)


The complete elimination of software defects during software development process is very difficult to attain in practice. In addition to well-known technical difficulties of the software development and testing process [Lyu96, Musa96], practical constraints such as the intense pressure to shrink time-tomarket and cost of software contribute to the difficulties in assuring 100% defect free software. Therefore, the current scenario in the computer industry is having systems in which software defects do exist but no one knows exactly where they are, when they will reveal themselves, and, above all, the possible consequences of the activation of the software faults. In a world where components of the shelf (COTS) are used more and more to build larger systems, the residual software faults represent a growing risk. The use of fault injection to emulate the effects of real software faults has been recognized as potentially very useful. We identify three major goals for the emulation of software faults:
Henrique Madeira, DEI-FCTUC, 2006

Logos

Prediction of worst case scenarios and risk assessment. The emulation of software faults can be used as a way to quantify the impact of software faults from the user point of view and get a quantitative idea of the potential risk represented by residual faults [Voas97]. Validation of fault tolerant mechanisms. As typical software faults left in deployed systems are rarely triggered, the validation of fault tolerant mechanisms can be achieved by accelerating the software fault activation through the emulation of software faults [Arlat01]. Dependability benchmarking. One recent research effort is centered on the definition of dependability benchmarks [Brown00]. Techniques to emulate software faults are essential for the benchmark faultload. From Introduction of a research paper: Henrique Madeira and Joo Dures
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

48

Henrique Madeira

24

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Logos na escrita persuasiva


Frases claras Diviso lgica e inteligente dos pargrafos Ligao coerente entre pargrafos O leitor deve entender a estratgia de escrita
Henrique Madeira, DEI-FCTUC, 2006

Como se consegue isto?


Usar repetidamente o ciclo de leitura curto para melhorar frases e pargrafos. Usar repetidamente o ciclo de leitura largo para melhorar a organizao e interligao entre pargrafos. Nunca se perde tempo quando se l repetidamente o que se acabou de escrever. a nica maneira de atingir um bom resultado.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

49

Pathos em estado puro

ebay
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

50

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

25

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Mais pathos em estado puro (1)

Slim Fast

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

51

Mais pathos em estado puro (2)

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

52

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

26

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Mais pathos em estado puro (3)

Nike
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

53

Mais pathos em estado puro (4)

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

54

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

27

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Mais pathos em estado puro (5)

Lego
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

55

Mais pathos em estado puro (6)

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

56

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

28

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Mais pathos em estado puro (7)

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

57

A arte da escrita persuasiva


(Bulho Pato acusou Ea de Queiroz de o ridicularizar na figura de Toms de Alencar, um poeta menor e personagem algo pattico em Os Maias. Ea escreve para um jornal tentado convencer os leitores de que Bulho Pato no tem razo) . No! Estes traos de superfcie, comuns a todos, no individualizam ningum. O que diferena e caracteriza os homens... o seu modo de ser moral, o conjunto das qualidades e dos defeitos. Ora Toms de Alencar tem defeitos e qualidades, separados e alternados, que vo desde a carraspana at ao cavalheirismo. Em quais das virtudes ou dos vcios se reconheceu o poeta da Paquita? Se foi nas virtudes, ento aqui vemos um homem que solenemente se adianta, cercado dos seus amigos, e exclama para o pblico, com a fronte alada: - Apareceu a um romance em que h um tipo de poeta, que tem lealdade, generosidade, uma honradez perfeita!... Ora com to esplndidas qualidades s eu existo, em Portugal. Esse poeta, portanto, sou eu! Neste caso, nunca nas idades modernas se teria visto um to burlesco exemplo de pedantismo e de farfia. Mas se o Sr. Bulho Pato se reconheceu nos defeitos, ento aqui temos um homem que em meio dos seus amigos se acerca do pblico e declara com solenidade: - Apareceu a um romance em que h um poeta que um medocre, um palrador, um farfante e um pitrireiro. Ora com to pfias qualidades s eu existo em Portugal. Esse poeta, portanto, sou eu! Neste caso, nunca no mundo se teria visto to doloroso exemplo de rebaixamento e de aviltamento prprio. Pro, pelo respeito que devo ao poeta. Mas quantas cruis e esmagadoras concluses uma pena mais hbil e maligna do que a minha poderia sacar desse paralelo a que o autor da Paquita to gratuitamente se ofereceu e em que se comprazeu to levianamente! . In Polmicas de Ea de Queiroz, vol IV, tomo II, Europress, 1988, pp24-29
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

58

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

29

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de tema para escrita persuasiva


Tema
1. Introduo
Captar a ateno do leitor Introduzir a tese, de preferncia sob a forma de uma frase curta que foca a ateno do leitor

Numa conversa casual apercebe-se de que o Joo, um antigo colega de curso, est a pensar candidatar-se a um programa de 2. Corpo doutoramento nos Estados Unidos. Manda Fornecer evidncias que apoiem a tese e a opinio expressas na introduo. lhe um e-mail tentando convenc-lo a fazer O corpo tem pelo menos trs pargrafos (e um doutoramento em Portugal, e em frequentemente tem apenas trs). particular no DEI. Antecipar pontos de vista contrrios e Insira o texto no Moodle

Nota: o objectivo praticar a escrita de textos persuasivos, pelo que a lngua utilizada no , nesta fase, o mais relevante. 3. Concluso Sumariar os aspectos mais importantes dos No entanto, use preferencialmente o ingls.
argumento e reiterar o que se pretende que o leitor acredite ou aceite.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

59

primeira passagem pelos conceitos bsicos e estratgias


Aspectos bsicos
O processo de escrita Como abordar os leitores Estruturao de textos

Curso de escrita:

Tipos de escrita
Persuasiva Mostrar as diferenas ou similitudes entre Comparativa objectos, pessoas, etc. Descritiva Narrativa Expositiva Definio Descrio de processos
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

60

Henrique Madeira, DEI-FCTUC, 2006

tentar contra argumentar Usar estatsticas, factos, dados de investigao, experincias e exemplos da vida real que apoiem o ponto de vista do autor.

Henrique Madeira

30

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Comparaes
Discutir similitudes ou diferenas (entre objectos, pessoas, ideias, etc) para extrair uma concluso ou afirmar uma opinio. Quando focada nas diferenas, o objectivo essencialmente mostrar que um melhor do que o outro. As comparaes contrastivas podem tambm servir para esclarecer um dado aspecto. Quando focada nas similitudes, a comparao procura normalmente clarificar um ponto. Por exemplo:
Explicar uma linguagem de programao nova por comparao com uma linguagem j conhecida (assume que se conhece os leitores e que se sabe que eles j dominam a linguagem usada para comparao). Explicar o impressionismo na literatura por comparao com o impressionismo na pintura.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

61

Estrutura tpica de um texto comparativo


Tal como nos outros tipos de escrita, raramente um texto exclusivamente comparativo. O mais frequente haver passagens de natureza comparativa em documentos mais vastos. A estrutura tpica :
1. Afirmar o objectivo 2. Apresentar factos e argumentos para a primeira parte da comparao 3. Incluir um elemento de transio. Por exemplo:
Henrique Madeira, DEI-FCTUC, 2006

Para contrastes: por outro lado, ao invs, inversamente, etc Para semelhanas: de igual modo, da mesma forma, similarmente, etc

4. Apresentar a segunda parte da comparao 5. Concluso

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

62

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

31

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Estratgias para desenvolver pargrafos comparativos


Antes de escrever identificar as grande zonas de similitudes e diferenas nos objectos a comparar. Fazer uma tabela com os objectos a comparar e os critrios a usar na comparao. Usar as colunas ou as linhas da tabela para comparar os objectos de forma consistente. Decidir que critrios de comparao devem ter mais relevo e influenciar mais marcadamente as concluses (se tratamos todos os critrios do mesmo modo a comparao perde fora). A
Diferenas Semelhanas Diferenas

Critrio Preo Fiabilidade Rudo Conforto

Mercedes

Fiat
Henrique Madeira, DEI-FCTUC, 2006

Sempre que possvel (e conveniente), ilustrar a comparao com grficos e imagens que reforcem os critrios que queremos realar.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

63

Exemplo (escrita tcnica)

Java is a lot like C, which makes it relatively easy for C programmers to learn. However, one of the main areas in which Java differs from C, of course, is that Java is an object-oriented language and has mechanisms to define classes and create objects that are instances of those classes. This chapter explains those differences, so that programmers who already know C can start programming in Java right away!
Henrique Madeira, DEI-FCTUC, 2006

Adapted from: http://www.oreilly.com/catalog/javanut/excerpt/index.html

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

64

Henrique Madeira

32

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo (escrita literria)


Cascais, 7 de Setembro de 1914. Meu jovem camarada e amigo: - Pede-me V. um artigo para o seu jornal A Restaurao. Esse pedido eu o agradeo e me apresso a satisfaz-lo porque o considero um testemunho de solidariedade e de simpatia prestado pela sua valorosa e combativa gerao, que a gerao dos meus netos, encanecida e aposentada gerao a que eu perteno. A orientao mental da mocidade contempornea comparada orientao dos rapazes do meu tempo estabelece entre as nossas respectivas celebraes uma diferena de nvel que desloca o eixo do respeito na sociedade em que vivemos, obrigando a elite dos velhos a inclinar-se rendidamente perante a elite dos novos.
Henrique Madeira, DEI-FCTUC, 2006

Em face da batalha de sentimentos e de ideias no conflito portugus dos nossos dias, entendo que ala dos veteranos cabe o dever marcial de apresentar as suas antigas armas a essa nova ala de namorados, que se no batem j pelo perecvel prestgio da sua dama mas pela beleza imortal da sua convico, e batem-se no em combate fortuito, de torneio de gala, mas em pugnas regulares e sucessivas em que quotidianamente arriscam os seus interesses, a sua liberdade e a sua vida os redactores dos modernos jornais monrquicos e os de publicaes peridicas de to considervel importncia filosfica e educativa como a Lusitnia, a Nao Portuguesa, Aqui d'El-Rei, os Cadernos de Mariotte, a Alma Portuguesa, a Crnica Poltica, a Entrevista, etc..... Ramalho Ortigo

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

65

Escreva duas verses do mesmo texto sobre o seguinte tema


Tema
Um colega que frequenta o 1 ano do Mestrado em Engenharia Informtica pede-lhe opinio sobre as duas alternativas para efectuar a Dissertao/Estgio: a) escolher uma proposta de Estgio de um professor do DEI, o que implica permanecer no DEI durante o 2 ano do curso e integrar um projecto de investigao do professor em causa ou b) optar por um Estgio numa empresa, indo, naturalmente, para a empresa em causa e efectuando o estgio no mbito de um projecto dessa empresa. Texto verso 1: Escreva um email ao seu colega fazendo uma comparao neutral, em que procura orientar a sua escolha e mostrar as vantagens e desvantagens de cada opo de forma sucinta. Texto verso 2: Assuma claramente uma preferncia e use um texto comparativo para convencer o seu colega a escolher um dos dois tipos de Estgios. Os dois textos so inseridos no Moodle (os dois no mesmo post para que se possa ver facilmente as diferenas)
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

1. Afirmar o objectivo 2. Apresentar factos e argumentos para a primeira parte da comparao 3. Incluir um elemento de transio. Por exemplo:
Para contrastes: por outro lado, ao invs, inversamente, etc Para semelhanas: de igual modo, da mesma forma, similarmente, etc

4. Apresentar a segunda parte da comparao 5. Concluso

66

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

33

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Outro exemplo de tema para escrita de comparaes


Tema
O dono da empresa em que trabalha decidiu iniciar o desenvolvimento de aplicaes informticas na empresa, criando um pequeno departamento de desenvolvimento de software. Sabendo que existe cdigo aberto e cdigo comercial, pede-lhe um pequeno texto comparando os dois mundos, focando em particular a perspectiva de desenvolvimento de aplicaes (usando cdigo aberto ou cdigo comercial). Texto verso 1: Comparao neutral em que procura orientar a escolha do seu patro dando-lhe a informao necessria de forma sucinta . Texto verso 2: Assuma claramente uma preferncia e use um texto comparativo para convencer o seu patro a adoptar o tipo de software que tu ache melhor. Os dois textos so inseridos no Moodle (os dois no mesmo post para que se possa ver facilmente as diferenas)

1. Afirmar o objectivo 2. Apresentar factos e argumentos para a primeira parte da comparao 3. Incluir um elemento de transio. Por exemplo:
Para contrastes: por outro lado, ao invs, inversamente, etc Para semelhanas: de igual modo, da mesma forma, similarmente, etc

4. Apresentar a segunda parte da comparao 5. Concluso

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

67

primeira passagem pelos conceitos bsicos e estratgias


Aspectos bsicos
O processo de escrita Como abordar os leitores Estruturao de textos

Curso de escrita:

Tipos de escrita
Persuasiva Comparativa Descrever uma pessoa, um lugar, objecto, cena Descritiva de forma a que o objecto da descrio seja efectivamente visualizado pelo leitor. Narrativa Expositiva Definio Descrio de processos
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

68

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

34

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Descrio
Descrever um objecto, uma cena, uma pessoa, etc. O objectivo fornecer uma imagem em palavras. A escrita descritiva utiliza frequentemente uma estratgia espacial: de cima para baixo, da esquerda para a direita, de perto para longe e de longe para perto. Muito importante: o objectivo no simplesmente descrever o objecto mas sim usar a descrio como parte de um propsito mais vasto. A descrio usada como parte da estratgia de convencimento.
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

69

Aspectos a ter em conta na escrita descritiva


A descrio no deve ser determinada pelo que o autor v mas sim pelo que o leitor precisa de imaginar para ver o objecto, pessoa ou cena alvo da descrio. Usar linguagem sensorial. No abusar de adjectivos e de advrbios. Procurar incutir aco na descrio. Dar especial ateno ao som e ritmo das palavras (ler e reler o texto alto ajuda).
Henrique Madeira, DEI-FCTUC, 2006

No esquecer que o olhar permite ver um objecto como um todo num nico relance, mas tal no possvel pela palavra. Transformar esta limitao numa fora guiando o olhar do leitor e deixando-o ver, atravs da descrio, apenas o que interessa que o leitor veja. Evitar construes estticas e monocrdicas. Usar o equivalente escrito ao zoom ou aos varrimentos de cmara para dar um ar vivo descrio. Se possvel sugerir uma pequena histria implcita na descrio.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

70

Henrique Madeira

35

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Guiar os olhos do leitor

Janelas na vertical cortam os compartimentos do cho ao tecto.


Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

71

Guiar os olhos do leitor

Janelas na vertical cortam os compartimentos do cho ao tecto. Outras esto ali para a vista, rasgam-se na horizontal.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

72

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

36

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de descrio: o objecto

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

73

Guiar os olhos do leitor

Janelas na vertical cortam os compartimentos do cho ao tecto. Outras esto ali para a vista, rasgam-se na horizontal.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

74

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

37

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de descrio: o objecto

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

75

Exemplo de descrio
() A casa um mostrurio de efeitos arquitectnicos. Alguns compartimentos so completamente construdos volta de um pormenor e tudo na sala concentra a ateno nesse ponto, que transformado assim num por maior. O jogo com as janelas, todas em ferro e vidro, impressionante. Algumas esto ali para a vista, rasgam-se na horizontal, e outras cortam os compartimentos do cho ao tecto e servem para deixar entrar o som da queda de gua, atravs de um efeito acstico surpreendente. A moblia, em que as prateleiras so um elemento fundamental, funde-se na casa e deixa-nos na dvida se foi desenhada para a casa ou se a casa pura e simplesmente a envolveu. Aqui e alm as estantes adquirem a geometria exterior da prpria casa, como gavetas desencontradas. Noutros lados so as prateleiras que surgem em stios inesperados e que correndo ao longo das paredes de pedra nos dirigem o olhar para o exterior. Alis, tudo dentro da casa nos leva a olhar sempre para o exterior, que lindssimo qualquer que seja a estao do ano. Como por magia, assim que chegamos c fora h uma fora imensa que nos convida a entrar, como se aquelas formas bizarras encerrassem a promessa de um espao interior ainda mais extraordinrio. () Henrique Madeira
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

76

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

38

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de tema para escrita de texto descritivo


Tema
Escreva um pequeno texto descritivo sobre o objecto da foto que se segue. Pode (e deve) assumir que a descrio faz parte de um texto maior, servindo o propsito geral desse texto (que fica inteiramente sua escolha). O texto deve ser inserido no Moodle Descrever o que o leitor precisa de imaginar para ver o objecto. Usar linguagem sensorial. No abusar de adjectivos e de advrbios. Procurar incutir aco na descrio. Dar grande especial ateno ao som e ritmo das palavras (ler e reler o texto alto ajuda).
Henrique Madeira, DEI-FCTUC, 2006

Guiar o olhar do leitor deixando-o ver, atravs da descrio, apenas o que interessa que este veja. Usar o equivalente escrito ao zoom ou aos varrimentos de cmara para dar um ar vivo descrio. Se possvel sugerir uma pequena histria implcita na descrio.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

77

Outro exemplo para escrita de texto descritivo


Tema
Escreva um pequeno texto descritivo sobre o objecto da foto que se segue. Pode (e deve) assumir que a descrio faz parte de um texto maior, servindo o propsito geral desse texto (que fica inteiramente sua escolha). O texto deve ser inserido no Moodle Descrever o que o leitor precisa de imaginar para ver o objecto. Usar linguagem sensorial. No abusar de adjectivos e de advrbios. Procurar incutir aco na descrio. Dar grande especial ateno ao som e ritmo das palavras (ler e reler o texto alto ajuda).
Henrique Madeira, DEI-FCTUC, 2006

Guiar o olhar do leitor deixando-o ver, atravs da descrio, apenas o que interessa que este veja. Usar o equivalente escrito ao zoom ou aos varrimentos de cmara para dar um ar vivo descrio. Se possvel sugerir uma pequena histria implcita na descrio.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

78

Henrique Madeira

39

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

primeira passagem pelos conceitos bsicos e estratgias


Aspectos bsicos
O processo de escrita Como abordar os leitores Estruturao de textos

Curso de escrita:

Tipos de escrita
Persuasiva Comparativa Uma narrativa simplesmente uma histria. Descritiva Interessa-nos especialmente perceber como Narrativa podemos usar pequenas narrativas na comunicao tcnica. Expositiva Definio Descrio de processos
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

79

Narrativa
Um texto narrativo conta um pequeno episdio ou uma histria. Na comunicao tcnica usa-se narrativas para ilustrar uma ideia ou opinio. As narrativas so usadas tambm com frequncia para captar a ateno do leitor, especialmente em textos introdutrios. O texto narrativo muito fcil de organizar e tem uma estrutura simples, mas dos tipos de escrita mais difceis.
Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

80

Henrique Madeira

40

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Aspectos a ter em conta na escrita de narrativas


Usar ordem cronolgica (com flashbacks se necessrio). Apresentar sucessivamente os eventos que compem a histria. Mas uma narrativa muito mais do que uma mera sequncia de eventos. Deve incluir:
Personagens Contexto Cenrio Conflito Resoluo do conflito

Referir detalhes ajuda normalmente a dar corpo e credibilidade narrativa. Usar linguagem rica em imagens.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

81

Exemplo de narrativa
() A verdade que a professora Barbara no era alta. Para ser mais preciso, se desprovida dos ardis e pequenos truques com que tentava contrariar a imagem que a natureza lhe dera, ela seria mesmo bastante baixa. dos livros que o problema da altura pode ser atacado de duas maneiras: por cima ou por baixo. Pois ela utilizava os dois processos, ou seja, andava sempre encarrapitada nuns sapatos de salto desmesurado e usava um magnfico penteado de banana, nessa altura j cado em desuso, em que o cabelo se projectava para cima como um chapu de coco, seguro por laca e artes mgicas. Por junto, entre taces e cabeleira, ganhava uns bons vinte e cinco centmetros. Era uma mulher de extremos. Mas no era s a voz forte que contrastava com a sua pequena estatura. Havia ainda um outro trao que dominava toda a sua figura e que, por certo, desequilibrava qualquer julgamento esttico. Eram os seus enormes seios, que ela acondicionava a custo em soutiens feitos de encomenda e sobre os quais corriam histrias e adivinhas, tudo do mais escabroso. E em todas as aulas l entrava ela, passinho estugado e narizinho emproado, muito direita. Parava a meio do estrado e depois de um breve silncio l vinha a discursozinho do dia, que ns ouvamos desatentos, mas que tinha sempre o condo de nos acalmar. Por fim, j com tudo em silncio, Brbara dirigia-se para a secretria, e uma vez sentada, nem os enormes saltos nem o imponente penteado de banana resolviam o problema da sua pequena estatura. Muito arrumadinha quase desaparecia atrs da secretria, e ao aproximar-se da mesa os seus enormes seios pousavam fartamente sobre o tampo. Depois, olhavanos muito sria e dizia: Posto isto, vamos nossa lio.
Henrique Madeira
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira
Henrique Madeira, DEI-FCTUC, 2006

82

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

41

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de tema para escrita texto narrativo


Tema
Escreva um pequeno texto narrativo para o seguinte filme. Assuma que a narrativa fazia parte de um texto maior que discutia a importncia da coeso entre os membros de uma equipa de desenvolvimento de software, encarregada de um projecto de grande dimenso e de elevada responsabilidade. O texto deve ser inserido no Moodle

1. Usar ordem cronolgica (com flashbacks se necessrio). 2. Apresentar sucessivamente os eventos que compem a histria mas incluir:
Personagens Contexto Cenrio Conflito Resoluo do conflito

3. Referir detalhes. 4. Usar linguagem rica em imagens

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

83

Outro exemplo de tema para escrita texto narrativo


Tema
Escreva um pequeno texto narrativo que que conte o essencial deste filme. Pode assumir que a narrativa fazia parte de um texto em que discutia as grandezas e misrias do comportamento humano nas pequenas vicissitudes do dia-a-dia. O texto deve ser inserido no Moodle

1. Usar ordem cronolgica (com flashbacks se necessrio). 2. Apresentar sucessivamente os eventos que compem a histria mas incluir:
Personagens Contexto Cenrio Conflito Resoluo do conflito

3. Referir detalhes. 4. Usar linguagem rica em imagens

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

84

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

42

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

primeira passagem pelos conceitos bsicos e estratgias


Aspectos bsicos
O processo de escrita Como abordar os leitores Estruturao de textos

Curso de escrita:

Tipos de escrita
Persuasiva Comparativa Descritiva Narrativa Expositiva Definio Descrio de processos

Exposio: fornecer informao ou explicar algo. Definio: definir termos, objectos ou ideias.
Henrique Madeira, DEI-FCTUC, 2006

Anlise de processos: explicar os passos de um processo ou de um algoritmo.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

85

Exposio
Texto que fornece informao ou que explica algo. O objectivo informar, explicar, esclarecer um assunto. Frequentemente designado por texto informativo-expositivo. Os textos expositivos so relativamente frequentes, particularmente em escrita tcnica. Aparecem tambm associados a outras formas de escrita:
Pargrafos expositivos como parte de textos descritivos ou narrativos, muitas vezes como forma de proporcionar informao inicial ao leitor Texto expositivo-argumentativo, que procura defender uma tese, recorrendo normalmente a factos que a confirmem.

Uma exposio deve ser:

Clara Credvel No deve assumir que o leitor tem algum conhecimento sobre o assunto

A credibilidade de um texto expositivo est normalmente associada s fontes de informao, que so referidas directa ou indirectamente (Ethos).
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

86

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

43

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de exposio (1)


Comunicado da ANACOM, 03.12.2007
(http://www.icp.pt/render.jsp?contentId=540674) No final de Setembro de 2007 existiam em Portugal cerca de 1,68 milhes de clientes do servio fixo de acesso Internet em Portugal, mais 2,3% que no trimestre anterior e mais 9,2% que no trimestre homlogo. Deste nmero, 94%, correspondentes a 1,57 milhes de clientes, utilizam Internet de banda larga fixa. Os utilizadores de banda larga mvel ascendiam a 1,18 milhes. O nmero de utilizadores de banda larga fixa - 1,57 milhes, mais 50 mil clientes que no trimestre anterior - aumentou 3,3% relativamente ao trimestre anterior e 16% face ao trimestre homlogo. A principal tecnologia de acesso Internet em banda larga fixa , desde final de 2004, o ADSL, que representa 62% do total (cerca de 971 mil clientes). O modem cabo utilizado por cerca de 37% dos clientes da banda larga fixa (cerca de 585 mil clientes). No que diz respeito banda larga mvel, o nmero de utilizadores com acesso Internet atingiu os 1,18 milhes, mais 199 mil utilizadores que no trimestre anterior, perodo em que existiam 984 mil utilizadores. Os utilizadores de banda larga mvel activos no perodo de reporte cresceram cerca de 33%, ascendendo a 478 mil utilizadores. ()
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

87

Exemplo de exposio (1)


Novo mineral mostra que Marte teve gua em estado lquido durante mais mil milhes de anos
29.10.2008 - 19h03 PBLICO (http://ultimahora.publico.clix.pt/noticia.aspx?id=1348010) A NASA descobriu que Marte teve gua em estado lquido durante mais mil milhes de anos do que se julgava. A sonda Mars Reconnaissance Orbiter (MRO), que orbita o planeta vermelho para estudar a sua geologia, descobriu a existncia de opala, um mineral formado a partir de silcio e que necessita de gua em estado lquido para existir. Esta extenso de tempo aumenta as possibilidades de ter existido vida em Marte. A MRO, dos Estados Unidos, chegou ao planeta vermelho em 2006 para fazer uma anlise mais profunda da geologia e meteorologia marciana. A sonda tem uma capacidade de anlise 20 vezes mais aguda do que qualquer outro aparelho que j olhou para o planeta, e conseguiu identificar pela primeira vez este tipo de minerais. O estudo vai ser publicado na edio de Novembro da revista cientfica Geology. ()
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira
Henrique Madeira, DEI-FCTUC, 2006

88

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

44

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de exposio (2)


() Acabo de ler o ltimo livro de Onsimo Teotnio Almeida: ONZE PROSEMAS (e um final merencrio). Trata-se de mais uma peregrinao interior deste autor da mundividncia literria que, desta vez, se exprime e expressa em prosemas (poemas em prosa) que Eduno de Jesus considera um gnero realmente novo. Para mim, trata-se de um novo gnero... Estes prosemas so fotogramas a trepidar na fita da memria de Onsimo. No so crnicas, so poemas narrativos. No so histrias, so (breves) monlogos pronunciados, pensados e sentidos. E tudo isto num registo de escrita com capacidade descritiva e evocativa. Aqui se cruzam informaes, citaes, memrias, revisitaes, referncias, acontecimentos, intertextualidades. E tudo isto com um q.b. de ateno carinhosa, irnica e por vezes mordente que o autor dedica aos outros. Exemplos: o velhote de S. Jorge (do poema do Carlos Faria) que diz: No trabalho mais, porque no quero morrer rico a trabalhar. Ou aquela do corvino a quem Onsimo havia oferecido um livro e que, meses depois, diz que ainda no havia encontrado tempo para o ler... Ou ento a Llia catarinense que, em plena conferncia, afirma considerar-se aoriana de 250 anos, ao que o cego do Onsimo responde do fundo da sala: Olhe que est muito bem conservada ... Mais uma vez estamos perante o prazer do texto de que falava Barthes. Gostei particularmente do Prosema a uma Brianda. Mais do que uma homenagem a Dona Ana Rocha Alves, trata-se de uma belssima declarao de amor cidade de Angra do Herosmo. ()
Victor Rui Dores
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira 89

Definies
Texto em que se define um objecto, um conceito, uma palavra, etc. As definies surgem normalmente como pargrafos (uma definio por pargrafo) e so usadas frequentemente em escrita tcnica. Uma definio no reproduzir o que dito num dicionrio (muitas vezes, os dicionrios no incluem os termos que preciso definir em escrita tcnica).
Henrique Madeira, DEI-FCTUC, 2006

A definio pressupe que o leitor conhece o contexto assumido na escrita da definio. Se necessrio, identificar o contexto explicitamente. Dizer o que um objecto no pode ajudar. Mas no se deve abusar desta estratgia (que na verdade inverte o que se espera de uma definio).
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

90

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

45

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplos de definies
Fault injection
Fault injection consists of the deliberate insertion of artificial faults in a computer system or component in order to assess its behaviour in the presence of faults and allow the characterization of specific dependability measures [Carreira et al. 1998].

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

91

Descrio de processos
Diz aos leitores como devem proceder para fazer algo. Muito frequente em escrita tcnica (descrio de algoritmos, manuais de utilizador, instrues de instalao, etc.). Algumas regras:
Definir o objectivo claramente (o que os leitores devem fazer ou aprender) Ser preciso e claro. Comear pelo incio. Indicar preparao prvia (se existir), material necessrio, ingredientes, etc. Usar uma abordagem passo-a-passo ( muito importante escolher o grau de detalhe certopara o leitor alvo). Seguir uma ordem estritamente cronolgica Nunca usar flashbacks! No caso de se aperceber de que se esqueceu de indicar algo voltar atrs e alterar/acrescentar o texto necessrio no passo em causa. Descrever o resultado esperado (final ou intermedirio) tal como o leitor o dever ver/aperceber.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

92

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

46

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Aspectos a considerar na descrio de processos


Apesar de ser fcil organizar um texto de descrio de processos normalmente difcil tornar este tipo de textos interessante. No esquecer que:
O objectivo no entreter ou divertir. Mas uma descrio chata no eficaz. Se possvel, e adequado, comear com uma pequena histria (narrativa).

muito importante assumir o contexto certo e ter a certeza de que os leitores tm os conhecimentos necessrios.
Henrique Madeira, DEI-FCTUC, 2006

Explicar globalmente o processo. Definir os termos necessrios. Inclui explicaes para os passos menos bvios. Usar caixas de texto (ou hiper-texto se for um documento digital) para evitar que o leitor que no necessita das definies e explicaes adicionais tenha que as ler.

Usar diagramas e imagens sempre que necessrio (e possvel).


Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

93

Bons e maus exemplos de descrio de processos


http://www.mirc.com/install.html http://diveintomark.org/archives/2003/08/04/xp http://www.debian.org/devel/debian-installer/translations.txt

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

94

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

47

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exemplo de descrio de processos


Para a execuo deste prato, mundialmente conhecido, indispensvel que o lavagante esteja bem vivo. Corta-se ento o lavagante, com a faca bem afiada, pelas juntas ou articulaes, segurando-o firmemente pela cabea com a mo esquerda, tendo cuidado para no rebentar a tripa; seguidamente, corta-se a cabea em duas, no sentido do comprimento, e retira-se-lhe com garfo prprio toda a carne. Guardam-se parte as ovas e os intestinos. Numa caarola, aquece-se bem (sem deixar ferver) o azeite e os 30g de manteiga ou margarina; deitam-se-lhe dentro os pedaos do lavagante e deixam-se saltear at que a carne fique bem rija e a carcaa tenha adquirido um tom vermelho-vivo. Tapa-se ento a caarola e vira-se para escorrer bem a gordura. Deitam-se sobre o lavagante as cebolinhas picadas e o alho; adiciona-se-lhes o conhaque previamente queimado, o vinho branco, a gua de cozer peixe, a gelatina de carne, a massa de tomate, a salsa e a pimenta. Coze durante 15 a 20 minutos no forno, com a caarola tapada. Retira-se toda a carne dos bocados da carcaa e pem-se num prato fundo, de prex ou de casquinha, colocando de p as duas metades da cabea e as pinas encostadas umas s outras, para efeito decorativo. Conservar bem quente. Reduz-se o molho de preparar o lavagante a 2 dl; incorporam-se-lhe as ovas e os intestinos, amassando-se tudo muito bem, e deixase cozer um instante. Passa-se este molho pela peneira e aquece-se novamente sem deixar ferver. Fora do lume, mistura-se-lhe a restante manteiga em pedacinhos e deita-se tudo sobre o lavagante. Polvilha-se com um pouco de salsa picada. Serve-se de imediato. In Tesouro das Cozinheiras, Mirene, Porto Editora, 1994, pp251-252
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira
Henrique Madeira, DEI-FCTUC, 2006

95

Exemplo de tema para escrita de descrio de um processo


Tema
Explique como um utilizador de Microsoft Excel dever proceder para fazer o grfico que se segue. Tenha em ateno os seguintes aspectos ao planear o texto: importante assumir com clareza o que o leitor alvo conhece sobre informtica e sobre a utilizao de Excel. Se possvel, a descrio deve cumprir objectivos pedaggicos, para alm da mera sequncia de instrues para reproduzir o grfico. O texto deve ser inserido no Moodle Descrio de processos Diz aos leitores como devem proceder para fazer algo Definir o objectivo claramente (o que os leitores devem fazer ou aprender) Ser preciso e claro. Comear pelo incio. Indicar preparao prvia (se existir), material necessrio, ingredientes, etc. Usar uma abordagem passo-a-passo.
Henrique Madeira, DEI-FCTUC, 2006

Seguir uma ordem estritamente cronolgica Nunca usar flashbacks! No caso de se aperceber de que se esqueceu de indicar algo voltar atrs e alterar/acrescentar o texto necessrio no passo em causa. Descrever o resultado esperado (final ou intermedirio) tal como o leitor o dever ver/aperceber.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

96

Henrique Madeira

48

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Aspectos bsicos de reviso e edio de textos


Henrique Madeira, DEI-FCTUC, 2006

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

97

Reviso e edio
Dificilmente um texto fica pronto primeira: sempre necessrio fazer revises devemos prever e planear as revises. Reviso
Voltar a ler o texto (re-viso) com o objectivo de melhorar o seu contedo e de tornar a escrita mais convincente e eficaz. Pode incluir alteraes da estrutura do texto, reescrita de frases, acrescento de novas frases ou eliminao de frases que so redundantes.
Henrique Madeira, DEI-FCTUC, 2006

Edio
Correco de gralhas, erros ortogrficos e pontuao. Inclui ainda o melhoramento do aspecto grfico do texto para que o produto final tenham o mximo impacto no leitor.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

98

Henrique Madeira

49

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Dois grandes tipos de reviso


Reviso de larga escala, que levam a alteraes profundas, quer na estrutura do documento quer no contedo.
Reorganizar a maneira como o material apresentado para melhorar a lgica de apresentao dos assuntos. Alargar ou estreitar o tese do texto. Acrescentar mais factos, ideias, exemplos; ou retirar os que so irrelevantes.

Refinar pargrafos, procurando as palavras mais adequadas para o efeito que se pretende produzir. Aperfeioar transies entre pargrafos. Combinar (ou separar) frases para melhorar a clareza e fluidez. Ajustar o tom (face ao tipo de leitores e objectivo do documento).

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

99

Planeamento de revises
Fazer primeiro revises de grande escala e s depois revises incrementais.
Pode ser intil refinar texto que vai ser posteriormente sujeito a uma reviso de larga escala.

Normalmente so necessrios vrias interaces dos dois tipos de revises (especialmente nas revises incrementais). Para documentos extensos (ou para captulos de documentos) frequente planear pelo menos trs passos:
Rascunho Verso de reviso Verso de edio
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira
Henrique Madeira, DEI-FCTUC, 2006

Uma reviso no pode ser feita de imediato! preciso guardar algum tempo (uma noite o ideal) entre escrever e fazer a reviso.

100

Henrique Madeira, DEI-FCTUC, 2006

Revises incrementais, que introduzem pequenos melhoramentos de estilo.

Henrique Madeira

50

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Rascunho
Primeiro esboo do texto
(Recordar tudo o que j se discutiu sobre como definir a tese, criar foco, pensar nos leitores, etc, etc. Recordar as regras bsicas de estruturao de textos). Comear por escrever a tese numa frase. Esboar estrutura macro (depende muito do tipo e tamanho do texto, podendo ir de captulos a pargrafos). Frases curtas com as ideias principais para cada parte (captulo, seco, )

Verificar o primeiro esboo


Henrique Madeira, DEI-FCTUC, 2006

Est completo (i.e., s deixa de fora matria que se pretende omitir)? Est consistente (i.e., as diferentes partes do rascunho servem a tese do texto)? Contm factos e ideias que apoiam a tese? A ordem pela qual o material apresentado a mais favorvel (recordar que no rascunho h apenas o esboo)? Se possvel, a reviso da estrutura deve ser feita no rascunho.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

101

Verso de reviso
Primeira verso completa do texto. Assumir que poderia ser dada a outra pessoa para comentar (leitor potencial ou um par). Nunca fazer a reviso imediatamente a seguir a ter acabado de escrever. Deixar para o dia seguinte, se possvel. Comear por uma reviso em larga escala, se necessria. Passar a sucessivas revises incrementais para melhorar o estilo.
Verificao (aplicar ao texto ou a

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

cada captulo, consoante o tamanho do texto): O texto serve o propsito esperado? A tese clara? A introduo capta a ateno do leitor e deixa claro qual o ponto principal do texto? A ideia principal de cada pargrafo est relacionada com a tese ou serve a apresentao da tese? As ideias esto ordenadas coerentemente? As transies entre pargrafos so adequadas? As frases so claras e bem estruturadas? A concluso encerra de forma inteligente o texto?

102

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

51

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Verso de edio
Garante que o aspecto final do texto tem a qualidade adequada (sem erros, apresentao adequada ao fim a que se destina, etc). Ler sem prestar ateno ao contedo, para total concentrao na deteco de erros de edio:
Erros ortogrficos e gralhas. M conjugao de verbos. Inconsistncias na pessoa (masculino/feminino, singular/plural). Repetio cacofnica de palavras. Incio de frases repetidos frequentemente (que sugerem escrita bsica, quase infantil). Utilizao consistente de aspas, parntesis, travesses, etc.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

103

Reviso por leitores potenciais ou por pares


O ideal conseguir que o texto (verso de reviso ou verso de edio) seja lido por um leitor potencial ou por um par (colega). Aspectos a ter em conta ao pedir a reviso de um texto a terceiros:
Deixar claro que tipo de reviso pretende.
Reviso essencialmente focada no contedo. Reviso do estilo. Verificar se o tom o apropriado. Verificar aspectos especficos (e.g., correco de exemplos apresentados). Reviso integral (normalmente s se pede a pares). A tese clara? A introduo capta a ateno do leitor? Verificar se a ligao entre o pargrafo X e Y est adequada. Etc.

Fornecer perguntas especficas ao revisor para melhor orientar a sua reviso.


Henrique Madeira, DEI-FCTUC, 2006

No adoptar uma atitude defensiva.


Aceitar a opinio dos leitores. Argumentar ou rebater a opinio de um leitor normalmente sinnimo de que o texto tem limitaes e precisa de ser melhorado. O objectivo ver o texto pelos olhos dos leitores e conseguir o mximo de informao.

Nunca esquecer que a deciso final cabe ao autor do texto.


Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

104

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

52

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Reviso crtica
A reviso crtica de um texto combina dois aspectos importantes:
Resumo do texto (o resumo frequentemente um super-resumo) Comentrio crtico

Para fazer uma reviso crtica


Ler e compreender o texto, identificando os pontos principais (tese, relevncia, propostas, etc). Analisar as propostas e argumentos apresentados no texto. Definir/identificar os critrios mais adequados para avaliar as propostas no texto. Escrever uma avaliao crtica.
Comea normalmente por apresentar de forma muito resumida a proposta ou propostas do texto (resumo) Avalia as propostas apresentadas no texto, de acordo com os critrios previamente definidos (comentrio crtico).

Apesar de a reviso crtica no se focar especialmente na maneira como o texto est escrito, a qualidade da escrita normalmente um dos critrios da avaliao.
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

105

Critrios de avaliao para revises crticas


Os critrios a usar nas revises crticas so muito dependentes do tipo de texto, do assunto abordado, dos fins em vista com a reviso crtica, etc. Exemplos de critrios genricos para texto tcnicos e cientficos:
Oportunidade: o texto actual e oportuno (ou intemporal)? Originalidade: h contribuies (ideias, propostas tcnicas, etc) originais? Relevncia: o assunto abordado relevante para o leitor alvo? Enquadramento: o assunto enquadrado adequadamente ficando claro para o leitor o contexto, conceitos, teorias e tcnicas que permitam ajuizar da oportunidade, originalidade e relevncia das ideias? Metodologia: o mtodo usado para desenvolver as ideias e avaliar as propostas adequando? Resultados: os resultados apresentados so interessantes e convincentes, permitindo corroborar as propostas? Validade:
O enquadramento vlido? O enquadramento aplicado de forma correcta? As propostas so justificadas e avaliadas correcta e convincentemente? As concluses so vlidas face ao exposto no texto?
Henrique Madeira, DEI-FCTUC, 2006

Qualidade da escrita: correco, clareza e estilo da linguagem utilizada.


Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

106

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

53

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Passos fundamentais para fazer uma reviso crtica


1. Passagem rpida pelo texto: ttulo, resumo, introduo, ttulos das seces e concluso. 2. Primeira leitura sem tirar notas para ficar com uma ideia global. 3. Segunda leitura tirando notas e destacando as ideias mais importantes. 4. Verificar as notas para garantir que incluem:
O objectivo e tema principal do texto Enquadramento e relevncia A metodologia seguida (no caso de haver metodologia) Principais concluses
Henrique Madeira, DEI-FCTUC, 2006 Henrique Madeira, DEI-FCTUC, 2006

5. Usar as notas para escrever o sumrio. Usar palavras prprias evitando copiar passagens do texto (que teriam de estar entre aspas). O sumrio comea por identificar o texto (ttulo) e o autor (nome, estatuto, etc).

6. Escrever comentrio crtico, seguindo os critrios de avaliao previamente identificados. Se estes no so explicitamente fornecidos ao revisor, este deve explicit-los no comentrios crtico (cada critrio uma pequena seco do comentrio crtico).
Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

107

Outros aspectos de revises crticas


frequente fornecer ao revisor uma grelha para avaliao dos textos. Essa grelha define explicitamente os critrios segundo os quais se deve processar a avaliao (comentrio crtico). tambm muito frequente a reviso crtica incluir uma seco com propostas para melhorar o texto (reviso crtica + reviso de contedo e estilo).

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

108

Henrique Madeira

54

Comunicao Tcnica
Departamento de Engenharia Informtica, FCTUC, 2008/2009

Exerccio: Reviso crtica + reviso de contedo e estilo


Tema
1. 2. 3. Formar grupos de dois alunos. Cada aluno faz a reviso crtica + reviso de contedo e estilo do texto entregue pelo colega na seco de Oficina de Escrita (Moodle) A submeter no Moodle Reviso crtica Identificar texto e autor como um post. Sumrio (3 linhas) Comentrio crtico Incluir o ficheiro attached Identificar a tese Avaliar argumentos ao post Avaliar concluso Qualidade de escrita: A tese clara e fcil de identificar? As frases so claras e bem estruturadas? A ligao entre pargrafos lgica e coerente? A concluso evidente e fcil de apreender? Reviso de contedo e estilo Copiar o texto do colega (1 quinzena de Outubro) para um documento Word Usar as ferramentas de reviso do Word para sugerir correces de frases e incluir comentrios que tenham a ver com a escrita. Submeter a ficheiro attached reviso crtica

4.

Escrita Tcnica, DEI-FCTUC, 2008/2009, Henrique Madeira

109

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira

55