Escrever código é fácilREADME.md é difícil. Muitas vezes, nos deparamos com uma página em branco (https://t.co/Bkh3Cq9AME) e não sabemos por onde começar, ou nossa documentação é obscura e difícil de entender, e ninguém quer lê-la. Encontrei por acaso esta coleção de recursos, Awesome Technical Writing, no GitHub. Ela organiza sistematicamente ferramentas, tutoriais e caminhos de desenvolvimento de carreira relacionados à redação técnica. Inclui diretrizes de estilo padrão de grandes empresas como Google e Microsoft, ajudando-nos a padronizar a terminologia e a formatação. Abrange também recursos completos de fluxo de trabalho, desde o planejamento de conteúdo e a arquitetura da informação até a publicação de documentos. GitHub: https://t.co/aSVRmWH7Ta Eles chegaram a compilar uma lista de programas de contribuição para documentação de código aberto, como o Google Season of Docs, além de uma lista de ferramentas auxiliares, como geradores de sites estáticos e verificadores de sintaxe. Seja você um desenvolvedor buscando otimizar a documentação de projetos ou planejando se dedicar integralmente à redação técnica, vale a pena guardar esta lista para consultas futuras.
