Add documentation about rooms.

https://bugzilla.mozilla.org/show_bug.cgi?id=1094771
I don't think "global api" has any significant meaning.  I would remove the heading I think (or find a better name but I don't have one in mind)