Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
I find it much more easier to have eveything here when you are reading the documentation.