https://techwriters.org/pt/TechWriters localized technical-writing feed.https://techwriters.org/pt/articles/accessible-code-examples-and-tables/https://techwriters.org/pt/articles/accessible-code-examples-and-tables/Thu, 13 Aug 2026 00:00:00 GMTA acessibilidade na documentação não termina com navegação e contraste. Exemplos de código, respostas JSON e tabelas de referência também precisam continuar claros e úteis sem depender apenas de cor.https://techwriters.org/pt/articles/ai-as-editor-not-oracle/https://techwriters.org/pt/articles/ai-as-editor-not-oracle/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Use IA como editora, não como oráculo, pensada para manter a documentação clara e sustentável. Como tratar «Use IA como editora, não como oráculo» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/ai-fact-checking-for-docs/https://techwriters.org/pt/articles/ai-fact-checking-for-docs/Thu, 13 Aug 2026 00:00:00 GMTTexto generativo pode soar completo enquanto inventa defaults, garantias ou citações. Estruture a verificação em torno de fontes autoritativas, exemplos executáveis e incerteza explícita. O erro perigoso de IA raramente é gramática ruim.https://techwriters.org/pt/articles/ai-learned-to-write-documentation/https://techwriters.org/pt/articles/ai-learned-to-write-documentation/Thu, 13 Aug 2026 00:00:00 GMTEm três anos, a IA generativa transformou o primeiro rascunho em uma operação barata. A questão central agora é quem responde por fatos, estrutura, revisão, atualização e qualidade.https://techwriters.org/pt/articles/api-examples-that-teach/https://techwriters.org/pt/articles/api-examples-that-teach/Thu, 13 Aug 2026 00:00:00 GMTUma request tecnicamente válida não é automaticamente um bom exemplo. Use valores realistas e sequências que revelem o modelo da API e ajudem o developer a prever o próximo passo. Um exemplo derivado do schema pode estar sintaticamente correto e não ensinar nada.https://techwriters.org/pt/articles/authentication-docs-that-prevent-support-tickets/https://techwriters.org/pt/articles/authentication-docs-that-prevent-support-tickets/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Documentação de autenticação que reduz tickets de suporte, pensada para manter a documentação clara e sustentável. Como tratar «Documentação de autenticação que reduz tickets de suporte» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/books-and-guides-for-technical-writers/https://techwriters.org/pt/articles/books-and-guides-for-technical-writers/Thu, 13 Aug 2026 00:00:00 GMTUma lista útil não é mais uma estante de clássicos. Compare guias mantidos por Microsoft, Google, GitHub e IBM, use Diátaxis para testar a estrutura e transforme cada leitura em um exercício real de documentação.https://techwriters.org/pt/articles/choosing-a-docs-generator/https://techwriters.org/pt/articles/choosing-a-docs-generator/Thu, 13 Aug 2026 00:00:00 GMTSphinx, MkDocs, Astro e outros geradores atendem modelos de conteúdo e equipes diferentes. Escolha pelo fluxo de autoria, extensibilidade, localização e custo de manutenção, não pela aparência da demo. Uma demo bonita pode ser errada para sua documentação.https://techwriters.org/pt/articles/choosing-search-for-docs/https://techwriters.org/pt/articles/choosing-search-for-docs/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Como escolher busca para documentação: comece pelos fracassos, pensada para manter a documentação clara e sustentável. Como tratar «Como escolher busca para documentação: comece pelos fracassos» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/deliberate-practice-for-docs/https://techwriters.org/pt/articles/deliberate-practice-for-docs/Thu, 13 Aug 2026 00:00:00 GMTLer sobre documentação ajuda, mas a habilidade cresce mais rápido com exercícios repetidos de pesquisa, reestruturação, edição e verificação, sempre com feedback claro. “Melhorar technical writing” é amplo demais.https://techwriters.org/pt/articles/diagrams-as-code-in-documentation/https://techwriters.org/pt/articles/diagrams-as-code-in-documentation/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Diagramas como código: quando ajudam e quando não ajudam, pensada para manter a documentação clara e sustentável. Como tratar «Diagramas como código: quando ajudam e quando não ajudam» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/docs-as-code-without-fanaticism/https://techwriters.org/pt/articles/docs-as-code-without-fanaticism/Thu, 13 Aug 2026 00:00:00 GMTDocs-as-Code não significa obrigar todo redator a trabalhar em uma IDE. O fluxo saudável combina fontes versionadas, edição no navegador, previews, verificações automáticas úteis, revisão humana e publicação previsível.https://techwriters.org/pt/articles/docs-tools-then-and-now/https://techwriters.org/pt/articles/docs-tools-then-and-now/Thu, 13 Aug 2026 00:00:00 GMTFormatos e pipelines mudaram radicalmente, mas os problemas duráveis são familiares: controle de fonte, reuse, navegação, review e sincronização entre produto e informação publicada. Muito antes do rótulo Docs-as-Code, equipes lidavam com múltiplas fontes, fragmentos reutilizados, versões e a dúvida sobre qual cópia era atual.https://techwriters.org/pt/articles/documentation-debt-triage/https://techwriters.org/pt/articles/documentation-debt-triage/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Dívida de documentação: como encontrar o que realmente prejudica usuários, pensada para manter a documentação clara e sustentável. Como tratar «Dívida de documentação: como encontrar o que realmente prejudica usuários» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/documentation-in-ci-cd/https://techwriters.org/pt/articles/documentation-in-ci-cd/Thu, 13 Aug 2026 00:00:00 GMTTrate documentação como artefato de build: valide estrutura, links, exemplos e regras antes da publicação. CI não decide se uma explicação é útil, mas rejeita defeitos previsíveis antes de gastar atenção humana.https://techwriters.org/pt/articles/documentation-lead-without-bureaucracy/https://techwriters.org/pt/articles/documentation-lead-without-bureaucracy/Thu, 13 Aug 2026 00:00:00 GMTUm lead de documentação deve reduzir incerteza, não adicionar uma camada de aprovação. Defina ownership, padrões e caminhos de escalonamento, mantendo a publicação rotineira rápida e perto de quem conhece o produto. Quando a documentação se espalha por várias equipes, surge a tentação de centralizar tudo.https://techwriters.org/pt/articles/documentation-metrics-that-matter/https://techwriters.org/pt/articles/documentation-metrics-that-matter/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Métricas de documentação mais úteis que visualizações de página, pensada para manter a documentação clara e sustentável. Como tratar «Métricas de documentação mais úteis que visualizações de página» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/documentation-ownership-map/https://techwriters.org/pt/articles/documentation-ownership-map/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Um mapa de responsabilidade da documentação sem burocracia, pensada para manter a documentação clara e sustentável. Como tratar «Um mapa de responsabilidade da documentação sem burocracia» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/documentation-review-workflow/https://techwriters.org/pt/articles/documentation-review-workflow/Thu, 13 Aug 2026 00:00:00 GMTUm bom processo torna a responsabilidade visível, reduz espera e separa revisão factual, editorial e de produto. Defina autor, revisor factual, editor e owner final.https://techwriters.org/pt/articles/documenting-api-errors/https://techwriters.org/pt/articles/documenting-api-errors/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Como documentar erros de API para permitir recuperação, pensada para manter a documentação clara e sustentável. Como tratar «Como documentar erros de API para permitir recuperação» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/documenting-rest-api/https://techwriters.org/pt/articles/documenting-rest-api/Thu, 13 Aug 2026 00:00:00 GMTBoa documentação de API combina contrato legível por máquina, explicações humanas, exemplos executáveis e comportamento de erro explícito. Documentação REST fala com máquinas e pessoas.https://techwriters.org/pt/articles/editing-drills-for-technical-writers/https://techwriters.org/pt/articles/editing-drills-for-technical-writers/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Exercícios de edição que melhoram a escrita técnica, pensada para manter a documentação clara e sustentável. Como tratar «Exercícios de edição que melhoram a escrita técnica» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/entering-technical-writing/https://techwriters.org/pt/articles/entering-technical-writing/Thu, 13 Aug 2026 00:00:00 GMTHá três anos, escrever bem, aprender algumas ferramentas e montar um portfólio podia bastar. Em 2026 a entrada ficou mais difícil: a IA produz rascunhos, as equipes estão menores e espera-se que o technical writer verifique fatos, entenda APIs, use Git e responda pelo sistema de documentação.https://techwriters.org/pt/articles/first-90-days-in-documentation-team/https://techwriters.org/pt/articles/first-90-days-in-documentation-team/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Os primeiros 90 dias em uma equipe de documentação, pensada para manter a documentação clara e sustentável. Como tratar «Os primeiros 90 dias em uma equipe de documentação» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/forum-questions-that-aged-well/https://techwriters.org/pt/articles/forum-questions-that-aged-well/Thu, 13 Aug 2026 00:00:00 GMTNomes de ferramentas mudam mais rápido que problemas editoriais. Ownership, terminologia, screenshots, reuse e review continuam voltando porque refletem decisões de sistema mais profundas. A resposta técnica passou de pastas compartilhadas para repositórios e ownership rules.https://techwriters.org/pt/articles/glossaries-and-terminology/https://techwriters.org/pt/articles/glossaries-and-terminology/Thu, 13 Aug 2026 00:00:00 GMTUm glossário é útil quando governa decisões no produto, interface e documentação, não quando apenas coleciona palavras. Uma entrada útil registra termo preferido, definição, variantes proibidas ou obsoletas, contexto e owner.https://techwriters.org/pt/articles/hiring-technical-writers-without-trick-tests/https://techwriters.org/pt/articles/hiring-technical-writers-without-trick-tests/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Como contratar technical writers sem testes-armadilha, pensada para manter a documentação clara e sustentável. Como tratar «Como contratar technical writers sem testes-armadilha» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/hypertext-before-modern-docs-portals/https://techwriters.org/pt/articles/hypertext-before-modern-docs-portals/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Hipertexto antes dos portais modernos de documentação, pensada para manter a documentação clara e sustentável. Como tratar «Hipertexto antes dos portais modernos de documentação» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/information-architecture-for-growing-docs/https://techwriters.org/pt/articles/information-architecture-for-growing-docs/Thu, 13 Aug 2026 00:00:00 GMTUma estrutura que funciona com cinquenta páginas pode falhar com quinhentas. Organize a navegação em torno das tarefas do usuário, tipos de conteúdo e conceitos duradouros, não do organograma. Um conjunto pequeno de documentação tolera quase qualquer navegação.https://techwriters.org/pt/articles/learn-api-docs-by-building-a-small-api/https://techwriters.org/pt/articles/learn-api-docs-by-building-a-small-api/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Aprenda documentação de API construindo uma API pequena, pensada para manter a documentação clara e sustentável. Como tratar «Aprenda documentação de API construindo uma API pequena» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/llm-content-pipeline-guardrails/https://techwriters.org/pt/articles/llm-content-pipeline-guardrails/Thu, 13 Aug 2026 00:00:00 GMTSe um modelo cria e atualiza conteúdo em escala, a validação precisa crescer junto. Restrinja entradas, preserve provenance, valide estrutura e separe geração da etapa privilegiada de publicação. Uma boa arquitetura assume que o modelo às vezes erra.https://techwriters.org/pt/articles/markdown-at-scale/https://techwriters.org/pt/articles/markdown-at-scale/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Markdown em escala: convenções que evitam o caos no repositório, pensada para manter a documentação clara e sustentável. Como tratar «Markdown em escala: convenções que evitam o caos no repositório» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/openapi-as-source-not-documentation/https://techwriters.org/pt/articles/openapi-as-source-not-documentation/Thu, 13 Aug 2026 00:00:00 GMTUma descrição OpenAPI pode gerar referência precisa, mas developers ainda precisam de conceitos, fluxos, autenticação, exemplos e recuperação de falhas que um schema sozinho não explica. OpenAPI descreve muito bem operações, parâmetros, requests, responses, status codes e schemas reutilizáveis.https://techwriters.org/pt/articles/portfolio-for-technical-writer/https://techwriters.org/pt/articles/portfolio-for-technical-writer/Thu, 13 Aug 2026 00:00:00 GMTEquipes de contratação precisam ver como você pesquisa, estrutura e verifica documentação. Um portfólio forte explica problema, restrições, processo e resultado, em vez de mostrar screenshots isolados. Um artigo polido prova que você consegue produzir texto polido.https://techwriters.org/pt/articles/release-notes-users-can-act-on/https://techwriters.org/pt/articles/release-notes-users-can-act-on/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Notas de versão em que o usuário consegue agir, pensada para manter a documentação clara e sustentável. Como tratar «Notas de versão em que o usuário consegue agir» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/structured-writing-rules-that-scale/https://techwriters.org/pt/articles/structured-writing-rules-that-scale/Thu, 13 Aug 2026 00:00:00 GMTConsistência em escala vem de modelos de conteúdo, terminologia e padrões reutilizáveis, não de pedir que todos memorizem um style guide enorme. Codifique as regras importantes em schemas e componentes. Uma equipe pequena pode depender de hábitos compartilhados e edição direta.https://techwriters.org/pt/articles/style-guide-people-use/https://techwriters.org/pt/articles/style-guide-people-use/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Um guia de estilo que as pessoas realmente usam, pensada para manter a documentação clara e sustentável. Como tratar «Um guia de estilo que as pessoas realmente usam» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/synthetic-examples-and-hallucinations/https://techwriters.org/pt/articles/synthetic-examples-and-hallucinations/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Exemplos sintéticos: rascunho útil, evidência perigosa, pensada para manter a documentação clara e sustentável. Como tratar «Exemplos sintéticos: rascunho útil, evidência perigosa» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/technical-writer-2006/https://techwriters.org/pt/articles/technical-writer-2006/Thu, 13 Aug 2026 00:00:00 GMTAs ferramentas mudaram radicalmente, mas o núcleo do trabalho continua reconhecível: público, evidência, estrutura, terminologia e responsabilidade. Em 2006 eram mais comuns desktop publishing, formatos de escritório e help systems mantidos manualmente.https://techwriters.org/pt/articles/technical-writer-skills-matrix/https://techwriters.org/pt/articles/technical-writer-skills-matrix/Thu, 13 Aug 2026 00:00:00 GMTUma boa matriz ajuda no desenvolvimento e na contratação. Uma ruim transforma traços vagos em falsa precisão. Meça capacidades observáveis e a complexidade dos problemas de documentação que a pessoa consegue assumir. Equipes costumam criar matrizes quando a contratação fica inconsistente ou promoções se tornam subjetivas.https://techwriters.org/pt/articles/vale-style-linting/https://techwriters.org/pt/articles/vale-style-linting/Thu, 13 Aug 2026 00:00:00 GMTStyle linting é valioso quando detecta deriva terminológica, linguagem de risco e defeitos editoriais repetíveis. Mantenha poucas regras, explicáveis e silenciosas o bastante para que uma falha tenha credibilidade. Um linter consegue revisar milhares de frases em segundos, então é tentador codificar toda preferência editorial.https://techwriters.org/pt/articles/wcag-22-for-documentation/https://techwriters.org/pt/articles/wcag-22-for-documentation/Thu, 13 Aug 2026 00:00:00 GMTAcessibilidade não é apenas uma tarefa de frontend. Autores controlam headings, propósito de links, alt text, tabelas, instruções e a estrutura usada por tecnologias assistivas. Um tema pode oferecer bom contraste e teclado, mas autores ainda determinam se o conteúdo é compreensível.https://techwriters.org/pt/articles/when-manuals-shipped-on-cd/https://techwriters.org/pt/articles/when-manuals-shipped-on-cd/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Quando os manuais eram distribuídos em CD, pensada para manter a documentação clara e sustentável. Como tratar «Quando os manuais eram distribuídos em CD» com critérios práticos, verificáveis e sustentáveis para documentação técnica.https://techwriters.org/pt/articles/working-with-subject-matter-experts/https://techwriters.org/pt/articles/working-with-subject-matter-experts/Thu, 13 Aug 2026 00:00:00 GMTUma abordagem prática e verificável para Como trabalhar com especialistas sem transformar toda revisão em reunião, pensada para manter a documentação clara e sustentável. Como tratar «Como trabalhar com especialistas sem transformar toda revisão em reunião» com critérios práticos, verificáveis e sustentáveis para documentação técnica.