oauth docs

[mattlub]

• [x] moves api docs to folder
• [x] fixes category links in api docs #133
• [x] creates oauth flow docs #103

heavily based on https://developer.github.com/apps/building-integrations/setting-up-and-registering-oauth-apps/about-authorization-options-for-oauth-apps/

[mattlub]

@des-des added how to get client id etc. made other changes to improve clarity

[m4v15]

Simple example of the oauth flow from the client side here https://github.com/m4v15/OTP_Oauth

• maybe we can have the app.js file in the docs?

[mattlub]

@m4v15 I would say link to it somewhere in our documentation.

[des-des]

Happy for you too merge this more stuff can be added in another pull if there is more you want to add

[m4v15]

@mattlub I fixed the merge conflicts (there weren't any locally for me, I don't really understand what happened). I then changed the GET and POST clients docs to be in the auth docs and secured them so that only SUPER's can post and view clients (for now)

[m4v15]

@mattlub cos I've made some changes I've left it for you to merge

[mattlub]

@m4v15 should that SUPER user stuff really be in the docs? I was under the impressions super users would literally only be us/the product owner

[m4v15]

@mattlub good point, moved