add REST documentation for following module
move common models out of module
remove server from REST endpoint keys
remove quotation marks from parameter descriptions to keep parser happy
use enum syntax in model parameters
move REST models to separate file
clarify return descriptions
follow up from review
Merge branch 'restdoc-following' of https://github.com/sathomas/Hilary into restdoc-following
Follow up for following REST documentation