@@ -24,27 +24,27 @@ MongoDB applications use one of two methods for relating documents:
24
24
cases.
25
25
26
26
#. :ref:`DBRefs <dbref>` are references from one document to another
27
- using the value of the first documents ``_id`` field collection,
28
- and optionally database name. To resolve DBRefs, your application
27
+ using the value of the first document's ``_id`` field collection,
28
+ and optional database name. To resolve DBRefs, your application
29
29
must perform additional queries to return the referenced
30
30
documents. Many :doc:`drivers </applications/drivers>` have helper
31
31
methods that form the query for the DBRef automatically. The
32
32
drivers [#offical-driver]_ do not *automatically* resolve DBRefs
33
33
into documents.
34
34
35
- Use DBRefs when you need to embed documents from multiple
35
+ Use a DBRef when you need to embed documents from multiple
36
36
collections in documents from one collection. DBRefs also provide a
37
- common format and type to represent these relationships between
38
- documents. DBRefs provide common semantics for representing these
37
+ common format and type to represent these relationships among
38
+ documents. The DBRef format provides common semantics for representing
39
39
links between documents if your database must interact with
40
40
multiple frameworks and tools.
41
41
42
- Unless you have a compelling reason for using DBrefs, use manual
42
+ Unless you have a compelling reason for using a DBref use manual
43
43
references.
44
44
45
45
.. [#offical-driver] Some community supported drivers may have
46
- alternate behavior and may resolve DBRefs into documents
47
- already .
46
+ alternate behavior and may resolve a DBRef into a document
47
+ automatically .
48
48
49
49
.. _document-references:
50
50
0 commit comments