From 76109d96ec3934ef3df3597bdf8d771b2e2da835 Mon Sep 17 00:00:00 2001 From: Bob Grabar Date: Mon, 10 Sep 2012 18:24:20 -0400 Subject: [PATCH 1/4] DOCS-487 updated Aggregation sign-post --- source/aggregation.txt | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) diff --git a/source/aggregation.txt b/source/aggregation.txt index 0e9a0bd5ff6..0d7ba7d3390 100644 --- a/source/aggregation.txt +++ b/source/aggregation.txt @@ -5,15 +5,31 @@ Aggregation =========== The :ref:`Aggregation framework ` provides -a natural method for aggregating data inside of MongoDB. This manual -contains documentation of both :doc:`aggregation itself -` and the :doc:`aggregation operators -`, as well as a collection of :doc:`example -aggregation operations `. +a natural method for aggregating data inside of MongoDB. + +Documentation +------------- + +The following document describes MongoDB aggregation: .. toctree:: :maxdepth: 3 applications/aggregation + +Tutorial +--------- + +The following tutorial provides examples of aggregation operations: + +.. toctree:: + :maxdepth: 1 + tutorial/aggregation-examples - reference/aggregation + +Reference +--------- + +The following reference section describes aggregation operators: + +- :doc:`/reference/aggregation` From facc085fbb90761e57e876a3691b8e9872707cb1 Mon Sep 17 00:00:00 2001 From: Bob Grabar Date: Mon, 10 Sep 2012 18:39:31 -0400 Subject: [PATCH 2/4] DOCS-487 updated Applications sign-post --- source/applications.txt | 42 ++++++++++++++++++++++++----------------- 1 file changed, 25 insertions(+), 17 deletions(-) diff --git a/source/applications.txt b/source/applications.txt index 9bd9acc2b09..4e210024d80 100644 --- a/source/applications.txt +++ b/source/applications.txt @@ -2,42 +2,50 @@ Application Development ======================= -These documents address application development with MongoDB. Most -applications interact with MongoDB using client libraries (drivers.) -The drivers provide language-specific interfaces to the database for -use in your applications. The :doc:`/applications/drivers` page -contains more information about the drivers themselves and links to -more through API-level documentation. - -Also consider the :ref:`administration tutorials -` that provide an introduction to basic -MongoDB use. The :doc:`aggregation ` and :doc:`indexes -` chapters provide an overview of topics with which every -MongoDB application developer will want familiarity. - -.. seealso:: ":wiki:`Developer Zone `" wiki pages and - the ":doc:`/faq/developers`" document. Developers also should be +MongoDB provides language-specific client libraries called +:term:`drives ` that let you develop applications to interact +with your databases. + +This page lists the documents, tutorials, and reference pages that +describe application development. + +For API-level documentation, see :doc:`/applications/drivers`. + +For an overview of topics with which every +MongoDB application developer will want familiarity, +see the :doc:`aggregation ` and :doc:`indexes +` documents. +For an introduction to basic +MongoDB use, see the :ref:`administration tutorials `. + +.. seealso:: :wiki:`Developer Zone ` wiki pages and + the :doc:`/faq/developers` document. Developers also should be familiar with the :doc:`mongo` shell and the MongoDB :doc:`query and update operators `. Application Development ----------------------- +The following documents outline basic application development topics: + .. toctree:: :maxdepth: 2 applications/drivers applications/database-references - tutorial/expire-data -.. seealso:: ":doc:`/applications/replication`." +.. seealso:: :doc:`/applications/replication` and + :doc:`applications/sharding`. .. _application-patterns: Patterns -------- +The following documents provide patterns for developing application features: + .. toctree:: :maxdepth: 2 tutorial/perform-two-phase-commits + tutorial/expire-data From df8bb4ba86cc1692bda39a3cfa89c2f5ecc17c34 Mon Sep 17 00:00:00 2001 From: Bob Grabar Date: Mon, 10 Sep 2012 18:43:26 -0400 Subject: [PATCH 3/4] DOCS-487 small edit to Applications sign-post --- source/applications.txt | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/source/applications.txt b/source/applications.txt index 4e210024d80..f3754801769 100644 --- a/source/applications.txt +++ b/source/applications.txt @@ -7,9 +7,8 @@ MongoDB provides language-specific client libraries called with your databases. This page lists the documents, tutorials, and reference pages that -describe application development. - -For API-level documentation, see :doc:`/applications/drivers`. +describe application development. qor API-level documentation, see +:doc:`/applications/drivers`. For an overview of topics with which every MongoDB application developer will want familiarity, From f42f0f3b38e9f0dbcb43db31fc4a533afc9b9c75 Mon Sep 17 00:00:00 2001 From: Bob Grabar Date: Tue, 11 Sep 2012 10:39:35 -0400 Subject: [PATCH 4/4] DOCS-487 revert Aggregation sign-post --- source/aggregation.txt | 27 +++++++-------------------- 1 file changed, 7 insertions(+), 20 deletions(-) diff --git a/source/aggregation.txt b/source/aggregation.txt index 0d7ba7d3390..2c5ca44df57 100644 --- a/source/aggregation.txt +++ b/source/aggregation.txt @@ -4,32 +4,19 @@ Aggregation =========== -The :ref:`Aggregation framework ` provides +Aggregation provides a natural method for aggregating data inside of MongoDB. -Documentation -------------- +For a description of MongoDB aggregation, see +:doc:`/applications/aggregation`. For examples of aggregation, see +:doc:`/tutorial/aggregation-examples`. For descriptions of aggregation +operators, see :doc:`/reference/aggregation`. -The following document describes MongoDB aggregation: +The following is the outline of the aggregation documentation: .. toctree:: :maxdepth: 3 applications/aggregation - -Tutorial ---------- - -The following tutorial provides examples of aggregation operations: - -.. toctree:: - :maxdepth: 1 - tutorial/aggregation-examples - -Reference ---------- - -The following reference section describes aggregation operators: - -- :doc:`/reference/aggregation` + reference/aggregation