From e31d2d531f965f6045167f549acc43ec22d08900 Mon Sep 17 00:00:00 2001 From: barrie Date: Wed, 9 May 2012 18:04:52 -0400 Subject: [PATCH] spelling, grammar, wording changes to DBRefs page --- draft/applications/database-references.txt | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/draft/applications/database-references.txt b/draft/applications/database-references.txt index 429be6e9f6d..ad5369429b2 100644 --- a/draft/applications/database-references.txt +++ b/draft/applications/database-references.txt @@ -19,15 +19,17 @@ MongoDB applications use one of two methods for relating documents: #. :ref:`Manual references ` where you save the ``_id`` field of one document in another document as a reference. - Then your application can run a second query to return the embeded + Then your application can run a second query to return the embedded data. These references are simple and sufficient for most use cases. -#. :ref:`DBRefs ` are a specification for relating documents - that captures the collection and database name. DBRefs are useful - when you may be emending documents from multiple collections, and - many :doc:`drivers ` automatically resolve - documents embeded with DBRefs. +#. :ref:`DBRefs ` are a reference from one document to another using an + ObjectId and a collection and database specification for the target + document. Using DBRefs requires two queries, both of which aren't done on + the server side, but are something that some of the drivers can interpret. + DBRefs are useful when you may be emending documents from multiple + collections, and many :doc:`drivers ` automatically + resolve documents embedded with DBRefs. Unless you have a compelling reason for using DBrefs, use manual references. @@ -75,9 +77,9 @@ the ``places_id`` field in the ``places`` collection. Use ~~~ -For nearly every case you want to store a relationship between two +For nearly every case in which you want to store a relationship between two documents, use :ref:`manual references `. The -references are simple to create and application can resolve references +references are simple to create and your application can resolve references as needed. The only limitation of manual linking is that these references do not @@ -156,7 +158,7 @@ Support interface provides automatic resolution of DBRef objects. **Perl** - The Perl driver contains no support for DBRefs, You can transverse + The Perl driver contains no support for DBRefs. You can transverse references manually or use the `MongoDBx::AutoDeref `_ CPAN module.