Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
Referring to already written parts of the documentation is IMO a good practice to keep the docs short and the indirection level isn't horrible here (I wouldn't say the same thing if we had sections which refer to each other in a complex way, but I don't think that's the case)