add documentation for REST models
order required properties first
Merge branch 'restdoc-messagebox' of https://github.com/sathomas/Hilary into restdoc-discussions