API description / Meta-information

[mikaa123]

Hi!
Thank you for the DSL/library; it's going to be incredibly useful to me and a lot of people.

Is there currently any way to describe the API as a whole (meta-information; such as what the API is intended to be used for, what are the different available processes, etc.)?

I think such information could prove valuable for middle to large APIs to see how the different 'services' fit together. What are your thoughts on it?

[mattetti]

That's a great idea. I'm not quite sure where that should live tho and that's probably why I was only providing end point specific documentation. Do you have a suggestion to provide more global documentation?