Goal: BSONObj, BSONElement, and any new classes introduced in this project are documented with explicit guidance on how to choose when to use each class and how types can be converted between one another.

This could be an arch guide.