use common permissions model
move messages models to message-box module
add documentation for REST models
order required properties first
Merge branch 'restdoc-messagebox' of https://github.com/sathomas/Hilary into restdoc-discussions
review followup
Merge branch 'restdoc-discussions' of https://github.com/sathomas/Hilary into restdoc-discussions