Thanks for the feedback (Firebase Community Manager here). We're working on improving the documentation. Feel free to email me at sara@firebase.com if you have more suggestions.