Como debuggar documentação em go em Go

"Você é um engenheiro de software sênior com vasta experiência em Go. Crie um guia passo a passo, detalhado e didático, para um desenvolvedor iniciante que deseja gerar automaticamente documentação de API RESTful a partir do código Go, utilizando ferramentas e práticas modernas do ecossistema Go. O guia deve cobrir desde a escolha da ferramenta (ex: Swagger/OpenAPI, GoDoc com anotações, etc.) e sua integração no processo de CI/CD, até a geração de um arquivo de documentação consumível (ex: JSON, YAML, HTML interativo) e a exibição em uma interface amigável. Inclua exemplos de código Go que ilustrem como anotar endpoints, structs e campos para que a ferramenta de documentação possa extrair as informações corretas. Aborde também as melhores práticas para manter a documentação atualizada e consistente com o código, e os desafios comuns e suas soluções."