@@ -19,15 +19,17 @@ MongoDB applications use one of two methods for relating documents:
19
19
20
20
#. :ref:`Manual references <document-references>` where you save the
21
21
``_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
23
23
data. These references are simple and sufficient for most use
24
24
cases.
25
25
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.
31
33
32
34
Unless you have a compelling reason for using DBrefs, use manual
33
35
references.
@@ -75,9 +77,9 @@ the ``places_id`` field in the ``places`` collection.
75
77
Use
76
78
~~~
77
79
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
79
81
documents, 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
81
83
as needed.
82
84
83
85
The only limitation of manual linking is that these references do not
@@ -156,7 +158,7 @@ Support
156
158
interface provides automatic resolution of DBRef objects.
157
159
158
160
**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
160
162
references manually or use the `MongoDBx::AutoDeref
161
163
<http://search.cpan.org/dist/MongoDBx-AutoDeref/>`_ CPAN module.
162
164
0 commit comments