In a RAML file (used for creating API docs), you can add arbitrary content outside of the endpoints by using the
documentation key, an array where each object has a
title property and Markdown-formatted
Example from the spec:
title: ZEncoder API
- title: Home
Welcome to the _Zencoder API_ Documentation. The _Zencoder API_
allows you to connect your application to our encoding service
and encode videos without going through the web interface. You
may also benefit from one of our
for different languages.
- title: Legal
content: !include docs/legal.markdown
Not sure why it took me ages to find this, it's right there in the first sections of the spec.