DATAMONGO-1019: Correct examples in reference documentation

* Examples were not properly converted
* One table got dropped, so add it back
* Fix IMPORTANT notes