phpDocumentor parece ser o padrão para documentar o código PHP, embora eu tenha que me perguntar por que ele não foi atualizado há anos ..?

No entanto, não parece adequado para documentar os pontos de entrada para uma API REST; IE, pontos de entrada acessíveis externamente nos quais um usuário final do seu sistema estaria interessado, em vez de documentar todas as classes internas e outras coisas - algo que apenas interessa aos desenvolvedores da AP

Estou procurando algo em que eu possa dizer: ei, esse método aqui é acessível externamente através de REST neste URL, aqui estão os argumentos GET ou POST, é compatível com métodos HTTP GET / POST / etc, retorna JSON ou XML ou qualquer outra coisa .

Esta informação seria capaz de produzir um documento API. Também poderia ser usado pelo código internamente para filtrar automaticamente entradas, validar saídas, criar testes básicos de unidade, et