Estratégias de documentação em php em PHP

"Você é um especialista em PHP e documentação técnica. Gere um guia prático, passo a passo, para desenvolvedores PHP que precisam criar documentação de API RESTful usando PHPDoc para classes e métodos, e Markdown para exemplos de uso e estrutura geral do README.md. O guia deve cobrir desde a escolha de tags PHPDoc relevantes até a organização de um README.md claro e navegável, com foco em otimizar a legibilidade para outros desenvolvedores e a capacidade de geração automática de documentação (ex: com Swagger/OpenAPI). Inclua exemplos de código PHP com PHPDoc e trechos de Markdown, e sugira ferramentas ou boas práticas para manter a documentação sincronizada com o código."