Some more text on the API docs pages
Merge pull request #513 from rmcgibbo/docs-narative

Some more text on the API docs pages