Un recursos interesante para tener a mano cuando tenemos que ponernos a documentar un API:
Donde tenemos unos ejemplos, Seleecionados, muy gráficos de como mostrar la documentación de nuestras APIs.
Si sabeis de alguna interesante no hay más que hacer un pull request a: