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.
Gestão de Conhecimento
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?
Gestão de Conhecimento
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.
Desenvolvimento
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.
Desenvolvimento
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.
TI Corporativa
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.
TI Corporativa
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?
TI Corporativa
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.
Desenvolvimento
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.