Fix warning
Add write API documentation

We **need** to have something that we can point third-parties at.
Merge pull request #40 from alphagov/document-write-api

Document Write API