Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
This misses an example. We have examples for all of the API we expose, so rooms should not be an exception.