Tech writing e a cultura de gestão da informação no Itaú

Por Angela Oliveira, Team Member na Comunidade Builders Hub no Itaú

O mundo da tecnologia vai muito além de códigos e novas linguagens. Nele, a redação técnica, ou em inglês — technical writing, também faz parte e têm o papel de transmitir instruções ou orientações ao leitor de forma clara e intuitiva para que, quem esteja lendo, possa compreender mais facilmente como usar uma solução, software ou produto. Assim, a redação técnica pode potencializar a disseminação de conteúdos sobre a tecnologia entre os times de forma inclusiva e democrática.

Neste artigo, vamos falar como funciona o technical writing no Itaú Unibanco, mergulharemos no que é gestão da informação e sua relação com a cultura de documentação em tech.

Agora, bora entender o que é tech writing na prática?

O que é tech writing

Tech writing (ou redação técnica) vai muito além de documentar um produto tech. Ela está nos artigos científicos que você lê, na bula do remédio, no planejamento de uma empresa e até naquele manual de montagem do móvel da sala. A pessoa preparada pra essa escrita e gestão da informação é a tech writer.

A pessoa tech writer tem o papel de transformar informações técnicas e complexas em textos claros e acessíveis para o público em geral, atuando como uma ponte entre especialistas e pessoas usuárias e tornando o conhecimento tecnológico mais fácil de entender e aplicar.

Assim, mais que documentação, technical writing é um gênero de escrita voltado para a produção de materiais que explicam processos, instruções ou conceitos, tendo suas normas, guias de estilo, além de algumas boas práticas, a fim de ser útil e inclusiva.

Esse tipo de escrita visa padronizar a informação, de forma que ela fique completa e acessível pra todo mundo.

Como a prática se aplica no Itaú

Um dos pontos mais importantes quando se trata de informação no Itaú é que ela esteja segura, porém acessível pra todas as pessoas que precisam dela dentro do banco. Ou seja, não importa se a pessoa vai usar um leitor de telas, legendas, libras ou precisar de uma linguagem mais específica no conteúdo, ela deve conseguir consumi-lo.

Por isso, na nossa Tecnologia, contamos com um processo de governança da informação bem estabelecido, cuidando de todas as áreas de atuação. Isto é, tanto faz se é uma documentação de produto, API, processo, interna ou para os pares, tudo deve seguir um padrão.

Para isso, contamos com tech writers espalhados em toda a área, que além de cuidar da gestão da informação nos seus times, também trocam muita ideia e ajudam o time de governança com novos padrões, ideias, templates e muito mais. Uma galera incrível, que sempre chega junto e faz a diferença.

Detalhe interessante: temos também nossos desbravadores da documentação, os doc advocates. Eles são responsáveis por manter viva a cultura de doc nos seus times e levar o estandarte da gestão da informação na área de tecnologia.

Governança da gestão da informação no Itaú

O que nutre qualquer negócio é a informação. Por isso, é essencial termos cuidado para a distribuirmos de forma com que ela circule pelos meios e pessoas certas, com regras e fluxos padronizados. É aí que entra a gestão da informação.

Nesse processo, chamamos de gestão de conhecimento o processo de organizar, capturar e compartilhar informações. Ou seja, é a base que vai permitir que sua empresa tenha a informação certa, completa e atualizada, no lugar e pra pessoa certa.

Cada vez mais as decisões são tomadas com base em dados e informações, gerando mais conhecimento para as organizações. Se elas estiverem espalhadas, imprecisas ou desatualizadas, além de perder tempo, também se corre o risco de definir estratégias erradas.

Ou seja, ter gestão da informação é pensar em qualidade em todas as pontas.

Por que tech writing é importante?

Segurança, transparência e agilidade. Essas são as três palavras que traduzem uma boa gestão da informação. Quando se trabalha o technical writing, elas fluem mais facilmente. É claro que essa tríade é fundamental para o Itaú.

Primeiro, a segurança, que é a base de tudo. Mesmo com todas as normas, procedimentos e tecnologias robustas envolvidas na troca de informações numa estrutura de banco, a segurança deve ser o foco de cada pessoa, inclusive nas suas trocas do dia a dia, como na documentação de um produto ou processo.

A transparência, que permite a troca entre os times e mostrando os caminhos tomados, traz uma maior integração entre as partes, o que facilita o inner source e a inovação. Claro que também traz agilidade, evitando perder horas em busca de uma informação, levando fluidez aos processos.

Pra que tudo isso aconteça, é importante fortalecer a cultura de documentação, reforçando as boas práticas, ferramentas, padrões, templates e todas as frentes que ajudam os times a documentarem e disponibilizarem suas informações — sempre no local e da forma correta.

Parece simples, mas na prática pode ser bem desafiador firmar uma cultura: estamos falando de pessoas. Lembre-se sempre de que cultura é sobre pessoas, seus desafios, resistências e motivadores.

A governança tem um papel fundamental nessa formação da cultura de documentação. Afinal, se você tem estrutura e direcionamento, tem consolidação. Claro que não podemos deixar de fora a comunicação dessa cultura — parte que eu tenho um carinho especial.

Trabalho incrível, né? Gosto de usar uma analogia nas talks que a gente faz para os times do Itaú, que resume bem esse processo.

• Imagine que o Itaú é um corpo, as comunidades/tribos são órgãos e suas subdivisões são células.
• Cada célula se nutre de dados, informações e conhecimento.
• Pra que os dados cheguem nas células, precisamos das artérias condutoras, nossas documentações.
• Para orquestrar tudo isso, impulsionando o fluxo e as trocas de informações, está a gestão do conhecimento.

Chegamos ao fim deste artigo com aquela sensação boa de que temos ainda muito a conversar sobre o tema.

Você já conhecia a gestão da informação e sua importância pra segurança, modernização e eficiência? Conta aí nos comentários, se você já conhecia ou tem contato com esse universo da documentação técnica e aproveita pra deixar as suas dúvidas e sugestões de próximos temas.