# References — Automation Documentation

> Curadoria (2026) para documentar automações: README executável e manutenível.

## Docs canônicas
- [Write the Docs Guide](https://www.writethedocs.org/guide/) — princípios de documentação técnica
- [Diátaxis](https://diataxis.fr) — documentação por tarefa (tutorial/how-to/reference/explanation)
- [awesome-readme](https://github.com/matiassingers/awesome-readme) — templates de README

## Referências e inspiração
- [makeareadme](https://www.makeareadme.com) — o que um README bom tem
- [Semantic versioning](https://semver.org) — versionar a automação
- [CHANGELOG (Keep a Changelog)](https://keepachangelog.com) — registro de mudanças

## Comunidade / tutoriais
- [Google technical writing](https://developers.google.com/tech-writing)
- [Man page (tldr)](https://tldr.sh) — documentação curta e copiável
- [.env.example convention](https://github.com/motdotla/dotenv#readme) — config sem segredos