Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
I believe we should put the participants description in another section and refer to it from here and the /rooms endpoint.