Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
it means we are duplicating the single source of truth, and our work to update the docs. + we can introduce errors without noticing since we feel we're reading the same thing twice (for instance, I haven't read this section because I read it already).