mongoid/mongoid-site — pull request #167 by fullbridge-batkins (2012-07-19 15:10:14+00:00)
Title: A warning about hash field key values

This pull request adds a warning on the Documents page regarding ensuring that hash keys adhere to [Mongoid's legal key names](http://www.mongodb.org/display/DOCS/Legal+Key+Names), otherwise you risk data loss on all data set on an instance of a `Mongoid::Document` prior to calling `save` on said document (or `refresh`).

This is in response to the discussion on [issue 2107 on the Mongoid github repo](https://github.com/mongoid/mongoid/issues/2107).

This seemed to be the most appropriate location for such a warning, but anyone can feel free to tweak this, or change the location of it as they see fit. (Or even reject it in favor of a link to this warning elsewhere). Cheers!