Latex - Aula Prática 2 O seguinte texto deverá ser escrito no formato de um artigo, com o título sendo "Resumo do Pequeno Manual da Escrita Técnica", e o autor o seu nome. Este texto contém quatro listas e duas seções. Veja o arquivo .pdf com o resultado final. Note que as palavras em inglês devem estar em itálico, bem como algumas palavras ou frases no início dos itens da lista da segunda seção. O texto está a seguir: ===================================================================== O seguinte texto é composto de trechos extraídos do Relatório Técnico RT-DINF 004--2004, do professor Roberto A. Hexcel, Departamento de Informática, UFPR. Estilo Segue uma lista de recomendações quanto a erros freqüentes e alguns vícios, também comuns. Os itens são numerados para facilitar referências a eles. Em função do enfoque do texto, algumas definições podem ser omitidas, desde que elas sejam obviamente conhecidas da grande maioria dos possíveis leitores. Na dúvida, aponte para uma referência bibliográfica. Nao use definições por exemplo, nas quais um exemplo contém a definição de um conceito ou termo. Primeiro defina e então dê um ou mais exemplos. Note que esta é uma definição por exemplo. Nunca introduza um termo pela sua abreviatura. A maneira correta é: A rede padrão Fiber Distributed Data Interface (FDDI) é ... A FDDI interconecta ... Use termos e abreviaturas consistentemente ao longo de todo o texto. Evite anglicismos. Use uma expressão que melhor traduza O SENTIDO da expressão em Inglês e cite o termo original entre parênteses, entre aspas ou em itálico (in English ou in English). Nomes próprios, em geral, não necessitam ser traduzidos (protocolos, interfaces padronizadas, etc). Evite frases de aluno de primeiro grau, muito curtas ou infinitamente longas, e use vocabulário de adulto. O estilo do Hino Nacional é aceitável em poesia mas é ininteligível para uma parcela enorme da populaçãao, e portanto nao deve ser usado em textos técnicos de Computação. Geralmente, frases no estilo do Hino Nacional decorrem da confusão do autor enquanto as elabora, quando novas idéias lhe ocorrem e são imediatamente inseridas no texto. O indefeso leitor é então obrigado a tentar seguir o tortuoso fluxo de idéias do autor. Como regra geral, textos técnicos devem ser escritos na voz passiva e no presente. Voz passiva: O arquivo deve conter as seguintes informações... O programa efetua as operações na ordem especificada em... A implementação do protocolo examina os campos da mensagem e então... Voz ativa: Devemos colocar as seguintes informações no arquivo... As operações deverão ser efetuadas pelo programa... O protocolo deverá examinar... Na medida do possível, evite listas iniciadas com dois pontos. Contra exemplo: uma coisa, outra coisa, uma terceira coisa. Se a lista é realmente necessária, enumere os itens: (a) uma coisa, (b) outra coisa, e (c) última coisa. Se for necessário empregar uma lista de itens (buletada), os itens deveriam ficar todos na mesma página, e cada item deve ocupar uma linha. Se os itens forem longos, possivelmente uma separação em vários parágrafos resulta em layout que é visualmente mais agradável. Note que esta lista é um contra exemplo. Bestiário Exemplos que não devem ser seguidos. O tom dos comentários é um tanto sarcástico porque estes exemplos foram produzidos por pessoas com curso superior (quase) completo. Esta lista é numerada para que seus elementos possam ser referenciados por número, simplificando o trabalho de apontar eventuais erros aos seus autores. Este trabalho assume que X é o mesmo que Y... Suponho que o autor quer dizer que seu trabalho pressupõe, considera, ou admite que X é o mesmo que Y. Ou será que o trabalho vai assumir alguma outra identidade, tal como faz o Super Homem? Cuidado com traduções erradas do Inglês: assumption é presunção! Table entry é elemento da tabela e não entrada na tabela. Performance é desempenho. O programa roda... Programas são executados ou interpretados. Quem roda são as rodas. A Figura abaixo descreve... Figuras nao descrevem. Elas mostram, indicam, ilustram, equivalem a, e talvez substituam 1024 palavras. Quem descreve é o autor. Ondismo - Uso inadequado de onde no lugar de `quando', `no qual', `em que'. Gerundismo - Uso do gerúndio em títulos de seçõoes (Escrevendo programas ou Configurando o sistema). Estes títulos são típicos de livros da série For Dummies, o que já é razão suficiente para evitá-los. Isto é - Uso inadequado de isto é em duas situações freqüentes. Na primeira, o isto é tem função disjuntiva porque o autor descobriu ou elaborou nova e melhor definição para o que escreveu à esquerda do isto é e ficou com preguiça de re-escrever a frase toda. Na segunda situação, o isto é tem função conjuntiva porque o lado direito do isto é acrescenta informação ao que consta no lado esquerdo. Nos dois casos, a frase deve ser re-escrita e o isto é eliminado. Não-algo - Uso incorreto e preguiçoso do não à frente a uma palavra, geralmente no objeto da frase, ao invés da palavra correta. Exemplos: a não necessidade (prescinde?), a não entrega (descumprimento do prazo, desobrigação, incompetência?). As palavras abaixo não são sinônimos: esquema; modelo; método; política; mecanismo; metodologia; algoritmo; implementação; e arquitetura.