phpDocumentor parece ser el estándar para documentar código PHP, aunque tengo que preguntarme por qué no se ha actualizado en años ...?

Sin embargo, no parece adecuado para documentar los puntos de entrada para una API REST; IE, puntos de entrada accesibles externamente en los que estaría interesado un usuario final de su sistema, en lugar de documentar todas las clases internas y demás, algo que solo interesa a los desarrolladores de la API.

Estoy buscando algo donde podría decir, hey, este método aquí es accesible externamente a través de REST en esta URL, aquí están los argumentos GET o POST que toma, admite métodos HTTP GET / POST / etc., devuelve JSON o XML o lo que sea .

Esta información podría producir un documento API. También podría ser utilizado por el código internamente para filtrar automáticamente las entradas, validar la salida, crear pruebas unitarias básicas, etc.