Having documentation on your API is highly beneficial.  If it is well written you're likely going to receive less questions by consumers of your API about how it works.

Aglio is a nice tool that I've been using to generate API documentation. In goes the Markdown, out comes the beautiful documentation.