Un recursos interesante para tener a mano cuando tenemos que ponernos a documentar un API:

API Documentation Gallery

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:

github.com/yosriady/apidocs-gallery