@@ -19,15 +19,17 @@ MongoDB applications use one of two methods for relating documents:
1919
2020#. :ref:`Manual references <document-references>` where you save the
2121 ``_id`` field of one document in another document as a reference.
22- Then your application can run a second query to return the embeded
22+ Then your application can run a second query to return the embedded
2323 data. These references are simple and sufficient for most use
2424 cases.
2525
26- #. :ref:`DBRefs <dbref>` are a specification for relating documents
27- that captures the collection and database name. DBRefs are useful
28- when you may be emending documents from multiple collections, and
29- many :doc:`drivers </applications/drivers>` automatically resolve
30- documents embeded with DBRefs.
26+ #. :ref:`DBRefs <dbref>` are a reference from one document to another using an
27+ ObjectId and a collection and database specification for the target
28+ document. Using DBRefs requires two queries, both of which aren't done on
29+ the server side, but are something that some of the drivers can interpret.
30+ DBRefs are useful when you may be emending documents from multiple
31+ collections, and many :doc:`drivers </applications/drivers>` automatically
32+ resolve documents embedded with DBRefs.
3133
3234Unless you have a compelling reason for using DBrefs, use manual
3335references.
@@ -75,9 +77,9 @@ the ``places_id`` field in the ``places`` collection.
7577Use
7678~~~
7779
78- For nearly every case you want to store a relationship between two
80+ For nearly every case in which you want to store a relationship between two
7981documents, use :ref:`manual references <document-references>`. The
80- references are simple to create and application can resolve references
82+ references are simple to create and your application can resolve references
8183as needed.
8284
8385The only limitation of manual linking is that these references do not
@@ -156,7 +158,7 @@ Support
156158 interface provides automatic resolution of DBRef objects.
157159
158160**Perl**
159- The Perl driver contains no support for DBRefs, You can transverse
161+ The Perl driver contains no support for DBRefs. You can transverse
160162 references manually or use the `MongoDBx::AutoDeref
161163 <http://search.cpan.org/dist/MongoDBx-AutoDeref/>`_ CPAN module.
162164
0 commit comments