Considerando a constante evolução das APIs e a necessidade de manter a documentação sempre atualizada e relevante para desenvolvedores, gere um guia detalhado e prático sobre como criar e manter uma documentação de API **dinâmica e auto-atualizável**.

O guia deve cobrir os seguintes pontos, com foco em ferramentas e metodologias que minimizem o esforço manual e maximizem a precisão e a utilidade para o desenvolvedor:

1.  **Ferramentas e tecnologias recomendadas:**
    *   Quais frameworks/especificações (ex: OpenAPI/Swagger, AsyncAPI) são mais eficazes para automação?
    *   Como integrar ferramentas de geração de documentação (ex: Swagger UI, Redoc, Postman Documentation) diretamente ao ciclo de desenvolvimento (CI/CD)?
    *   Exemplos de uso de ferramentas de *linting* para garantir a consistência e a qualidade da especificação.

2.  **Estratégias de integração:**
    *   Como integrar a geração de documentação diretamente ao código-fonte da API (ex: comentários Javadoc/PHPDoc/Python docstrings para auto-geração)?
    *   Melhores práticas para versionamento da documentação em conjunto com o versionamento da API.
    *   Como automatizar a publicação e o *deployment* da documentação (ex: para um portal de desenvolvedores, GitHub Pages, etc.).

3.  **Manutenção e feedback:**
    *   Métodos para coletar feedback dos desenvolvedores sobre a documentação (ex: integrações com sistemas de *issue tracking*, *widgets* de feedback).
    *   Como usar métricas de uso da documentação para identificar áreas de melhoria.
    *   Estratégias para lidar com *breaking changes* e comunicar atualizações de forma eficaz e automatizada.

4.  **Exemplos práticos e *templates*:**
    *   Forneça um exemplo de *pipeline* CI/CD simplificado para automação da documentação.
    *   Inclua um *template* de estrutura de um arquivo OpenAPI com anotações para auto-geração de descrições e exemplos.

O objetivo final é que o guia permita a uma equipe de Relações com Desenvolvedores implementar um sistema onde a documentação da API seja **sempre um reflexo