Document functionality added in bug 1042850

Fair warning I've not written any documentation before so don't really know the syntax.
It got removed in https://github.com/mozilla/zamboni/commit/10acfad370d35e2082acc752e5ce55fede288548