Moved the api description to its own document

- changed formatting and added more content