Most recent articles by:

Sarah Siqueira

Sou pós-graduada pela FGV em Gerência de TI. Já fui programadora, tradutora, revisora, e atualmente sou redatora técnica há mais de 11 anos. Aprendi inglês muito nova, e descobri a redação técnica meio que por acaso, através de um anúncio de multinacional que precisava de alguém que escrevesse bem em português e inglês e tivesse disponibilidade para viagens. Lá trabalhei por 7 anos, viajei por todos os continentes, aprimorei técnicas, e entrei em contato mais profundo com o ciclo de vida do desenvolvimento de software no Brasil. Hoje sou líder de desenvolvimento de informações na IBM, onde planejo os projetos de documentação do produto sob minha responsabilidde, desenvolvo conteúdo, reviso materiais, dou treinamentos, mentorizo equipes mais novas e auxilio no processo de globalização e de teste da interface com os usuários finais. Espero trazer a vocês bons insights sobre o mundo da documentação em TI.
- Advertisement -spot_imgspot_img

Não crie obstáculos. Crie pontes!

Este post era para ser sobre o gerenciamento de conteúdo. Mas como falar de gerenciamento, e de conteúdo, sem falar daqueles que teimam em criar obstáculos?

Documentos: gerenciar ou não? Eis a questão

O gerenciamento de documentação, eu diria, é tão ou mais importante que a própria produção tecnológica em si. E quando eu digo documentação, eu incluo tudo – revisões de código, formulários de feedback de clientes, manuais, especificações técnicas, etc.

Deixe de lado o óbvio

Como documentadora eu ouço muito a célebre frase “Pra quê? Ninguém lê o que vocês escrevem mesmo...”. Levo na brincadeira, dou risada junto. Mas é claro que eu sei que a realidade é essa mesmo – quase ninguém lê manual... até a hora que precisamos resolver um problema. E, nesse momento, eu faço questão de fazer a diferença para o meu cliente.

DITA: Comunicação à moda Darwin

O processo de documentação em DITA é aquele em que a informação é dividida em pequenos tópicos que, por si mesmos, podem ser compreendidos.

Imagens valem mais que mil palavras… será?

Houve um tempo em que eu produzia por volta de 60-80 páginas de documentação por semana. Eram páginas e mais páginas que descreviam reuniões de levantamento de escopo de software com clientes.

Não menospreze o usuário!

O seu projeto de documentação baseia-se em (a) descrever todos os bits and bytes numa tela; (b) fazer com que todas as telas apareçam no manual; (c) ter um bom manual que ensina tudo, até como digitar o nome de usuário e senha?

Responsabilidade é o nome do jogo

Vou pegar o gancho de um artigo recente escrito por Luciano Pires, do Portal Café Brasil – para quem não conhece, eu recomendo a leitura. O artigo do Luciano fala sobre o atendimento recebido por ele quando ligou para o suporte do AdWorks® da Google.

Seja amigável, invista em documentação!

Se você é daqueles gerentes de TI que pensam que documentação é uma questão de produzir os manuais de usuário em tempo para o release do seu software, pense de novo.

Must read

Software para MSPs: indo além do preço ao procurar pelas ferramentas certas

Confira 5 dicas essenciais para escolher as melhores plataformas para compor o monitoramento e segurança da infraestrutura de TI dos seus clientes

Rápido, seguro e nativo: Chrome chega ao Windows no Snapdragon

"Projetamos o navegador Chrome para ser rápido, seguro e fácil de usar em desktops e dispositivos móveis, e estamos sempre procurando maneiras de levar essa experiência a mais pessoas", disse Hiroshi Lockheimer, Senior Vice President, Google.
- Advertisement -spot_imgspot_img