Melhores práticas de documentação em go para Go

Crie um guia interativo e multilíngue para documentar APIs RESTful em Go, utilizando as ferramentas e padrões mais recentes da comunidade (como OpenAPI/Swagger, GoDoc, e exemplos de código executáveis). O guia deve ser otimizado para desenvolvedores Go de diferentes níveis de experiência, permitindo que eles gerem documentação precisa e atualizada automaticamente a partir do código-fonte, e que essa documentação seja facilmente consumível por outros desenvolvedores e ferramentas externas. Inclua um fluxo de trabalho passo a passo, exemplos práticos para diferentes cenários de API (autenticação, validação, erros, etc.) e as melhores práticas para manter a documentação sincronizada com as mudanças no código.