O dia em que percebi que estava a ganhar 78.200 dólares por ano para “explicar coisas” ainda me parece um pouco irreal.
Estava numa sala de reuniões minúscula, com o portátil aberto, enquanto três engenheiros séniores discutiam uma funcionalidade que ninguém fora daquela sala conseguia entender.
Eram brilhantes.
E também falavam uma linguagem privada.
Comecei a fazer perguntas.
“Ok, então o que é que o cliente vê?”
Silêncio. Depois alguém se riu. “Sinceramente, não sabemos como dizer isto sem o diagrama.”
Foi aí que tudo fez sentido: o meu trabalho não era apenas escrever manuais.
O meu trabalho era traduzir caos em palavras que pessoas normais conseguissem seguir numa manhã de segunda-feira, com pouco café e muito stress.
E, de alguma forma, esse talento muito específico transformou-se num salário estável, médio, na área tecnológica.
Daqueles que eu nem achava possível para uma “pessoa de palavras”.
A parte estranha é como aconteceu tão discretamente.
De “redatora aleatória de escritório” a gestora de documentação
Quando as pessoas ouvem “gestora de documentação”, ficam com o olhar vazio.
Parece poeirento, como um cargo tirado de um organigrama corporativo de 1998.
Na realidade, os meus dias são rápidos, caóticos e estranhamente sociais.
Coordeno uma pequena equipa de redatores técnicos, persigo gestores de produto por respostas, entro em stand-ups de engenharia e discuto (com calma) com designers sobre terminologia.
O meu calendário é metade reuniões, metade tempo profundo de escrita.
A minha cabeça está sempre dividida entre duas perguntas:
“O que raio é que esta funcionalidade faz, afinal?”
“E como é que explico isto para que um utilizador stressado não desista furioso?”
Essa mistura de trabalho de detetive e narrativa foi o que me levou aos 78.200 dólares.
Sem cerimónia de promoção, sem champanhe.
Apenas um e-mail dos RH com um novo título, um número, e uma responsabilidade que, de repente, parecia muito real.
O caminho até lá não foi linear.
Comecei como “especialista de conteúdos” numa pequena empresa SaaS, o que basicamente significava fazer um pouco de tudo: artigos de blog, macros de suporte, o e-mail ocasional de onboarding que ninguém se lembrava de ter escrito.
Um dia, o nosso único redator técnico despediu-se.
O meu gestor mandou-me mensagem: “Consegues ajudar temporariamente com a documentação? Só até contratarmos alguém.”
Nunca contratámos ninguém.
Aprendi a fazer, fazendo.
Sentei-me ao lado de engenheiros, gravei as nossas conversas, reescrevi as explicações deles em inglês simples e depois vi os utilizadores ficarem menos confusos ao longo do tempo.
Os tickets de suporte diminuíram.
As vendas começaram a partilhar os meus guias nas demos.
Dezasseis meses depois, o nosso VP de Produto disse numa 1:1: “Tu já estás basicamente a gerir a documentação.
Vamos oficializar.”
O título mudou, a remuneração acompanhou e, de repente, eu estava na linha de “gestão” do organigrama.
No papel, o salto parece estratégico.
Na vida real, foi mais como reparar em fissuras e preenchê-las discretamente até ninguém conseguir imaginar o produto sem essa camada de clareza.
A documentação não grita por atenção.
Bugs gritam. Falhas de serviço gritam. Clientes irritados gritam.
Mas documentação limpa, consistente e pesquisável acalma uma empresa inteira.
O Suporte passa menos tempo a escrever as mesmas explicações.
Engenheiros podem enviar um link em vez de escrever uma mensagem de Slack com três parágrafos.
Novas contratações ganham ritmo sem uma semana de “Posso roubar-te um segundo?”
Essa calma tem valor de negócio, mesmo que ninguém a ponha em néon.
Quando a liderança percebe que o teu trabalho reduz o caos e poupa tempo em quatro ou cinco equipas, o título de gestora deixa de ser “bom de ter” e passa a ser lógico.
O que eu fiz, na prática, para crescer até uma função de documentação de 78.200 dólares
O ponto de viragem foi tratar a documentação como um produto, não como uma tarefa chata.
Comecei a fazer as mesmas perguntas que os gestores de produto faziam sobre funcionalidades.
Quem é o utilizador desta página?
Que tarefa está a tentar resolver às 15h de uma terça-feira, quando o chefe está à espera?
Como é que passa de “estou perdida” para “consegui” com o menor número de cliques?
Deixei de escrever “descrições de funcionalidades”.
Passei a escrever pequenas jornadas:
“Se queres fazer X, começa aqui. Clica nisto. Presta atenção àquilo.”
Depois de enquadrar assim, construí uma estrutura básica: modelos, normas de conteúdo, uma fonte central de verdade.
Muita gente ignora guias de estilo.
O truque é criar um que seja curto, utilizável e fácil de copiar/colar para a vida real.
Também tornei um hábito nada glamoroso na minha arma secreta: sentei-me com o Suporte.
Literalmente. Pegava numa cadeira extra, via-os responder a tickets e lia a linguagem crua e honesta que os clientes usavam quando algo falhava.
Começaram a surgir padrões.
As mesmas cinco confusões.
Os mesmos botões com nomes errados.
As mesmas perguntas “Espera, onde é que está essa definição outra vez?”
Esses padrões tornaram-se o meu roteiro.
Cada vez que transformava uma resposta desorganizada do Suporte num artigo reutilizável, eu etiquetava, acompanhava visualizações e partilhava pequenas vitórias.
“Equipa, depois de publicarmos o checklist de onboarding, os tickets sobre configuração de conta caíram 18%.”
Sejamos honestos: ninguém faz isto todos os dias.
Mas fazê-lo com regularidade suficiente deu à liderança algo que eles entendem instintivamente: números.
Eu não era apenas a “pessoa que escreve coisas”.
Eu estava, discretamente, a reduzir custos e fricção.
“Eu achava que a documentação era onde as palavras iam para morrer”, disse-me um engenheiro.
“Depois vi um utilizador passar tranquilamente por uma configuração que antes lhes demorava 40 minutos.
Agora envio-lhes os teus links antes sequer de entrar numa chamada.”
- Acompanha os teus utilizadores (shadowing)
Senta-te com Suporte, Vendas ou Customer Success algumas horas por mês.
Aponta as frases exatas que os utilizadores dizem quando estão bloqueados. - Assume primeiro um canto pequeno
Escolhe um fluxo: onboarding, faturação, integrações.
Transforma esse caos num guia limpo, de ponta a ponta, e mede resultados. - Cria normas leves
Um guia de estilo de uma página é melhor do que um PDF de 40 páginas que ninguém abre.
Mantém simples: voz, terminologia, capturas de ecrã, versionamento. - Partilha pequenos resultados, não objetivos grandiosos
“Os tickets sobre a Funcionalidade X caíram 12%” resulta melhor do que “Melhorámos a qualidade da documentação”. - Faz crescer relações, não apenas páginas
Entra cedo nos kickoffs de produto.
Oferece-te para nomear coisas, escrever tooltips e criar quickstarts antes do lançamento.
Como este trabalho se sente por dentro
O dinheiro é real, mas o que mais me surpreendeu foi a sensação de estar no cruzamento de tudo.
Como gestora de documentação, estás onde linguagem, design, produto e pânico humano se cruzam.
Ouves falar de funcionalidades antes do marketing.
Detetas desastres de nomenclatura que ninguém mais nota.
Recebes a primeira onda de feedback “Espera… isto não faz sentido” de utilizadores iniciais.
Alguns dias é frustrante.
És a última a ser informada, a primeira a ser culpada quando a documentação fica desatualizada.
Outros dias parece um superpoder silencioso: consegues desembaraçar uma confusão com uma única página bem estruturada.
Essa mistura de influência discreta e impacto prático é o que me mantém aqui, mesmo nos dias em que os tickets do Jira se acumulam como roupa por lavar.
| Ponto-chave | Detalhe | Valor para o leitor |
|---|---|---|
| A documentação é uma alavanca de negócio | Boas docs reduzem a carga do suporte, aceleram o onboarding e criam confiança | Ajuda-te a posicionar-te como mais do que “apenas uma pessoa que escreve” em conversas de salário |
| Age como um/a product owner | Define públicos, fluxos, normas e métricas de sucesso para o teu conteúdo | Dá-te um caminho claro de “contribuidor individual” para nível de gestão |
| Cresce pela proximidade à dor | Ouve dificuldades reais via Suporte, Vendas e testes com utilizadores | Mostra-te o que escrever primeiro e como demonstrar impacto com números |
FAQ:
- É preciso ter um background técnico para ser gestora de documentação?
Não necessariamente.
Precisas de ser curiosa e não ter medo de parecer “burra” enquanto fazes perguntas muito básicas.
Se consegues seguir lógica, aprender ferramentas por conta própria e traduzir jargão para linguagem simples, consegues evoluir para o lado técnico.- Com que ferramentas costumam trabalhar gestores de documentação?
Já usei Confluence, Notion, docs baseadas em Git e plataformas dedicadas como GitBook ou Help Scout.
As ferramentas importam menos do que a tua capacidade de manter uma fonte de verdade clara, com versionamento, pesquisa e uma forma simples de outras pessoas sugerirem edições.- Como chegaste a um salário de 78.200 dólares?
Ao ligar o meu trabalho a resultados: menos tickets de suporte, onboarding mais rápido, releases mais suaves.
Nas avaliações, levei exemplos reais e pequenas métricas, e depois pedi para ser nivelada ao lado de outros gestores que eram responsáveis por sistemas críticos.- A gestão de documentação é um percurso de carreira estável?
Sim, especialmente em software e ferramentas B2B.
Os produtos estão a ficar mais complexos e os utilizadores recusam-se a ler documentação má.
Empresas que levam documentação a sério costumam manter pelo menos uma pessoa a liderá-la a longo prazo.- Como é que alguém pode começar se a sua empresa não tem uma função formal de documentação?
Voluntaria-te para assumir uma parte pequena da documentação: uma única funcionalidade, onboarding ou um processo interno.
Mostra exemplos de antes/depois, partilha vitórias com o teu gestor e vai expandindo o teu âmbito até o trabalho que fazes corresponder claramente a uma função dedicada.
Comentários
Ainda não há comentários. Seja o primeiro!
Deixar um comentário