add required documentation
Merge branch 'restdoc-principals' of https://github.com/sathomas/Hilary into restdoc