Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
nit: this line sounds long, if it's longer than 80 chars, you should go on a new line.