@@ -21,8 +21,9 @@ Overview
2121--------
2222
2323In this guide, you can learn about the ``Mongoid::Document`` module in
24- {+odm+}. The ``Document`` module is a representation of a MongoDB
25- document. To learn more about the terminology, structure, and limitations of
24+ {+odm+}. The ``Document`` module is a {+language+} implementation of a
25+ MongoDB document, which stores data in field-and-value pairs. To learn
26+ more about the terminology, structure, and limitations of
2627MongoDB documents, see :manual:`Documents </core/document/>` in the
2728{+server-manual+}.
2829
@@ -45,13 +46,14 @@ in a sample ``Person`` model class:
4546You can find more information about the ``Document`` module in the `API
4647documentation <{+api-root+}/Document.html>`__.
4748
48- MongoDB Representation
49- ----------------------
49+ Work with Documents
50+ -------------------
5051
51- The representation of a ``Document`` in MongoDB is a BSON object that is
52- similar to a {+language+} hash or JSON object. You can store instances
53- of your models directly in a collection in the database, or you can
54- embed them in other classes that use the ``Document`` module.
52+ You can store instances of your models directly in a collection, or you
53+ can embed them in other classes that use the ``Document`` module.
54+ When you save a ``Document`` instance to MongoDB, it is converted
55+ to a BSON object that is similar to a {+language+} hash or JSON
56+ object.
5557
5658The following code creates an instance of the ``Person`` model defined
5759in the preceding section:
0 commit comments