Escrita Tecnica1

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

Apresentao oral de artigos cientficos
Henrique Madeira
Comunicao Tcnica
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.
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)
Henrique Madeira
Comunicao Tcnica
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

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)
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
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
Comunicao Tcnica
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
Aspectos bsicos do processo de escrita

Henrique Madeira
Comunicao Tcnica
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
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
Escrever bem uma atitude. No algo que se faz ocasionalmente quando se acha que as circunstncias ou os nossos leitores o merecem.
10
Henrique Madeira
Comunicao Tcnica
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
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.
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.
12
Henrique Madeira
Comunicao Tcnica
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:

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.
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

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.
14
Henrique Madeira
Comunicao Tcnica
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.
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.
16
Escrever a tese numa nica frase antes de fazer qualquer rascunho do texto.
Henrique Madeira
Comunicao Tcnica
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.
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.
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.
18
Henrique Madeira
Comunicao Tcnica
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!
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
1.2 Disciplinas
1.2.1 Anlise 1.2.2 Tecnologia de Computadores
2.
Mestrado em Engenharia Informtica
20
Henrique Madeira
10
Comunicao Tcnica
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?
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.1 Estruturais 2.1.1 TMR 2.1.2 Sobresselente a quente 2.2 Comportamentais
22
Henrique Madeira
11
Comunicao Tcnica
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.1 Estruturais 2.1.1 TMR 2.1.2 Sobresselente a quente 2.2 Comportamentais
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
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
24
Henrique Madeira
12
Comunicao Tcnica
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?
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!
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)
26
Estimar, mesmo que grosseiramente, o espao necessrio para cada seco.
Henrique Madeira
13
Comunicao Tcnica
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.
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. .
28
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
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
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.
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.
30
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
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.
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
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.
32
Henrique Madeira
16
Comunicao Tcnica
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:
No se usa abreviaturas nem grias. Escrita impessoal ou na terceira pessoa. Tom srio ou neutral.
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.
34
Henrique Madeira
17
Comunicao Tcnica
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:
Frases simplificadas e uso de abreviaturas. Grias e calo so normalmente aceitveis. Primeira e segunda pessoa. Tom normalmente ligeiro e uso frequente de humor.
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.
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
36
Henrique Madeira
18
Comunicao Tcnica
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
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,)
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).
38
Henrique Madeira
19
Comunicao Tcnica
39

Aspectos bsicos
Curso de escrita:
Persuasiva Narrativa Descritiva Expositiva Definio Comparativa Descrio de processos
40
Henrique Madeira
20
Comunicao Tcnica
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.
Alguns exemplos (usando verbos no infinito):

Explicar Justificar Avaliar Definir Expor Argumentar Comparar/Contrastar Sumariar Criticar Narrar Analisar Discutir Descrever Provar Informar
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.
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.
42
Henrique Madeira
21
Comunicao Tcnica

Aspectos bsicos
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
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:
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.
44
Henrique Madeira
22
Comunicao Tcnica
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.
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.
Pathos:
46
Henrique Madeira
23
Comunicao Tcnica
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:
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
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:
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
48
Henrique Madeira
24
Comunicao Tcnica
Logos na escrita persuasiva

Frases claras Diviso lgica e inteligente dos pargrafos Ligao coerente entre pargrafos O leitor deve entender a estratgia de escrita
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.
49
Pathos em estado puro
ebay
50
Henrique Madeira
25
Comunicao Tcnica
Mais pathos em estado puro (1)
Slim Fast
51
52
Henrique Madeira
26
Comunicao Tcnica
Nike
53
54
Henrique Madeira
27
Comunicao Tcnica
Lego
55
56
Henrique Madeira
28
Comunicao Tcnica
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
58
Henrique Madeira
29
Comunicao Tcnica
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.
59

Aspectos bsicos
Curso de escrita:
Tipos de escrita
Persuasiva Mostrar as diferenas ou similitudes entre Comparativa objectos, pessoas, etc. Descritiva Narrativa Expositiva Definio Descrio de processos
60
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
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.
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:
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
62
Henrique Madeira
31
Comunicao Tcnica
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
Sempre que possvel (e conveniente), ilustrar a comparao com grficos e imagens que reforcem os critrios que queremos realar.
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!
Adapted from: http://www.oreilly.com/catalog/javanut/excerpt/index.html
64
Henrique Madeira
32
Comunicao Tcnica
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.
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
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)
66
Henrique Madeira
33
Comunicao Tcnica
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)
67

Aspectos bsicos
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
68
Henrique Madeira
34
Comunicao Tcnica
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.
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).
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.
70
Henrique Madeira
35
Comunicao Tcnica
Guiar os olhos do leitor
Janelas na vertical cortam os compartimentos do cho ao tecto.

71
Janelas na vertical cortam os compartimentos do cho ao tecto. Outras esto ali para a vista, rasgam-se na horizontal.
72
Henrique Madeira
36
Comunicao Tcnica
Exemplo de descrio: o objecto
73
Janelas na vertical cortam os compartimentos do cho ao tecto. Outras esto ali para a vista, rasgam-se na horizontal.
74
Henrique Madeira
37
Comunicao Tcnica
Exemplo de descrio: o objecto
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
76
Henrique Madeira
38
Comunicao Tcnica
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).
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.
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).
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.
78
Henrique Madeira
39
Comunicao Tcnica

Aspectos bsicos
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
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.
80
Henrique Madeira
40
Comunicao Tcnica
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.
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
82
Henrique Madeira
41
Comunicao Tcnica
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:
3. Referir detalhes. 4. Usar linguagem rica em imagens
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:
3. Referir detalhes. 4. Usar linguagem rica em imagens
84
Henrique Madeira
42
Comunicao Tcnica

Aspectos bsicos
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.
Anlise de processos: explicar os passos de um processo ou de um algoritmo.
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).
86
Henrique Madeira
43
Comunicao Tcnica
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. ()
87

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. ()
88
Henrique Madeira
44
Comunicao Tcnica

() 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).
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).
90
Henrique Madeira
45
Comunicao Tcnica
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].
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.
92
Henrique Madeira
46
Comunicao Tcnica
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.
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).

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
94
Henrique Madeira
47
Comunicao Tcnica
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
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.
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.
96
Henrique Madeira
48
Comunicao Tcnica
Aspectos bsicos de reviso e edio de textos

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.
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.
98
Henrique Madeira
49
Comunicao Tcnica
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).
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
Uma reviso no pode ser feita de imediato! preciso guardar algum tempo (uma noite o ideal) entre escrever e fazer a reviso.
100
Revises incrementais, que introduzem pequenos melhoramentos de estilo.
Henrique Madeira
50
Comunicao Tcnica
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

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.
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

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
51
Comunicao Tcnica
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.
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.

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.

104
Henrique Madeira
52
Comunicao Tcnica
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.
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?
Qualidade da escrita: correco, clareza e estilo da linguagem utilizada.

106
Henrique Madeira
53
Comunicao Tcnica
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).
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).
108
Henrique Madeira
54
Comunicao Tcnica
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.
109
Henrique Madeira
55

Escrita Tecnica1

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Escrita Tecnica1

Enviado por

Direitos autorais:

Formatos disponíveis

Comunicao Tcnica

Departamento de Engenharia Informtica, FCTUC, 2008/2009

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

Departamento de Engenharia Informtica

Plano para o mdulo de escrita de artigos cientficos

Escrita de artigos cientficos Reviso de artigos cientficos

Apresentao oral de artigos cientficos

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

Planificao: aulas e palestras

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

Planificao: escrita e apresentao de artigos cientficos

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

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

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

Avaliao: escrita e apresentao de artigos

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

The research business

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

Aspectos bsicos do processo de escrita

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

primeira passagem pelos conceitos bsicos e estratgias

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

No h segredos apenas bons conselhos

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

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

O mais importante: saber ler o que escrevemos

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

Pensar antes de escrever

Henrique Madeira, DEI-FCTUC, 2006

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

Nunca esquecer a audincia

A audincia determina fortemente o texto

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

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

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

Voltar a pensar nos leitores

Henrique Madeira, DEI-FCTUC, 2006

Comear a tentar definir a estrutura do texto

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

Henrique Madeira, DEI-FCTUC, 2006

Princpios para correcta estruturao de textos

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

Coordenao correcta (ex. 1)

Coordenao correcta (ex. 2)

Mestrado em Engenharia Informtica

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

Henrique Madeira, DEI-FCTUC, 2006

3. Tcnicas de tolerncia a falhas

2. Tcnicas de tolerncia a falhas

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

Henrique Madeira, DEI-FCTUC, 2006

Henrique Madeira, DEI-FCTUC, 2006

2. Tcnicas de tolerncia a falhas

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

Estruturao: forma e estilo

2. Reviso dos seus prprios textos

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

Henrique Madeira, DEI-FCTUC, 2006

Rever principais perguntas antes de escrever

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

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

Examplo: estrutura de um artigo cientfico