Doc updates

Updates to `/docs` including new `/docs/readme` and `/apis` pages.

Haven't touched the repo readme or `/docs/environment` / `/docs/tech_overview` pages.. can do if required.

Feedback welcome!

Closes #1025