O padrão de documentação PHPDoc tornou-se referência para diferentes projetos em PHP, tanto em bibliotecas, frameworks, quanto em apps. Embora a chegada de typehints cada vez mais sofisticados no PHP tenha tornado alguns tipos de documentação redundantes ou desnecessárias, manter algumas descrições importantes em alguns tipos de classes e métodos ainda me parece um meio simples e eficaz de manter código e documentação caminhando juntos. Embora seja possível criar documentações apartadas da aplicação, é sempre útil poder recorrer diretamente a uma explicação no próprio código-fonte. Além disso, a proximidade entre código-fonte e documentação é um fator positivo para que a documentação não fique desatualizada, já que revisões no código acabam naturalmente exigindo uma revisão da PHPDoc.
Neste artigo, verermos como servir uma documentação em PHPDoc na própria estrutura de desenvolvimento de um repositório.