REST API documentation needs to be updated to reflect changes in 0.7.x branch

[mattheworiordan]

I think this is one for you. @kouno and I will tackle the client lib API docs.

[mattheworiordan]

@paddybyers we also need to have a page that explains how the limits work for our clients so that they understand any restrictions that may exist that they should be aware of.

[paddybyers]

Sure, there is some material we can start with in the old wiki.

[mattheworiordan]

This is done