Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Are there any plugins for generating API documentation for Play 2.x?

We have a relatively large REST API build on top of Play 2.x and are tasked with documenting it for our internal users. Since it is our belief that maintaining this on a separate wiki is very difficult, we are wondering if there are any documentation generating tools out there for Play?

like image 366
Mad Dog Avatar asked Nov 27 '13 19:11

Mad Dog


People also ask

What is Isapi documentation?

API documentation is a technical content deliverable, containing instructions about how to effectively use and integrate with an API.

What does API documentation contain?

API documentation is technical content that documents the API. It includes instructions on how to effectively use and integrate the API. It also provides updates on the API's lifecycle such as new versions or retirement. Some aspects of API documentation can be generated automatically via Swagger or other documents.


1 Answers

Swagger provides Play 2 support:

https://github.com/swagger-api/swagger-play

Play 2 itself provides documentation to its router in a convenient format, checkout what happens when you call:

Play.current.routes.foreach(r => println(r.documentation))
like image 163
James Roper Avatar answered Oct 23 '22 15:10

James Roper