Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
nit: sometimes you use a "dot" at the end of your lists, sometimes not. We should be consistent.