Skip to content

Commit e31d2d5

Browse files
committed
spelling, grammar, wording changes to DBRefs page
1 parent c36c332 commit e31d2d5

File tree

1 file changed

+11
-9
lines changed

1 file changed

+11
-9
lines changed

draft/applications/database-references.txt

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -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

3234
Unless you have a compelling reason for using DBrefs, use manual
3335
references.
@@ -75,9 +77,9 @@ the ``places_id`` field in the ``places`` collection.
7577
Use
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
7981
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
8183
as needed.
8284

8385
The 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

Comments
 (0)