DOCSP-27390 aggregation operations (#367)

* first draft

* add new file

* JS MK feedback

* fix

* remove mql

* fixes

* fixes

* fix

* DOCSP-28004: boolean operators (#330)

* DOCSP-27932: add AWS Lambda connection guide link (#317)

* DOCSP-27932: add AWS Lambda connection guide link

* DOCSP-27400: BsonCreator annotation description fix (#325)

* DOCSP-27400: BsonCreator annotation description fix

* DOCSP-25493: Adding links to the bson-records API (#326)

* DOCSP-25493: Adding links to the bson-records API

* Fixing broken link.

* DOCSP-27390 - Agg Expression Overview (#318)

* add new file

* JS MK feedback

* Revert "DOCSP-27390 - Agg Expression Overview (#318)"

This reverts commit 400fa99.

* Java 4.9 whats new (#329)

* DOCSP-27978: added exception for BsonCreator constructor
* DOCSP-27417: Command monitoring log format change

* DOCSP-28004: boolean expressions

* first pass fixes

* DOCSP-27974 - 4.9.0 Version Updates (#328)

* version updates

* cc feedback

* changes based on discussion

* CC PR fixes 1

* JS MK feedback

* fix

* PR fixes

* improve example explanation

* add toc landing page so agg page doesnt disappear

---------

Co-authored-by: Chris Cho <[email protected]>
Co-authored-by: DBirtolo-mdb <[email protected]>
Co-authored-by: Mike Woofter <[email protected]>
Co-authored-by: Mike Woofter <[email protected]>

* Revert "DOCSP-28004: boolean operators (#330)" (#335)

This reverts commit eb7f746c78b75b97f0f9a34cacf8571900e95f60.

* DOCSP-28004: boolean aggregation expression operators (#336)

* DOCSP-27932: add AWS Lambda connection guide link (#317)

* DOCSP-27932: add AWS Lambda connection guide link

* DOCSP-27400: BsonCreator annotation description fix (#325)

* DOCSP-27400: BsonCreator annotation description fix

* DOCSP-25493: Adding links to the bson-records API (#326)

* DOCSP-25493: Adding links to the bson-records API

* Fixing broken link.

* DOCSP-27390 - Agg Expression Overview (#318)

* add new file

* JS MK feedback

* Revert "DOCSP-27390 - Agg Expression Overview (#318)"

This reverts commit 400fa99.

* Java 4.9 whats new (#329)

* DOCSP-27978: added exception for BsonCreator constructor
* DOCSP-27417: Command monitoring log format change

* DOCSP-28004: boolean expressions

* first pass fixes

* DOCSP-27974 - 4.9.0 Version Updates (#328)

* version updates

* cc feedback

* changes based on discussion

* CC PR fixes 1

* JS MK feedback

* fix

* PR fixes

* improve example explanation

* add toc landing page so agg page doesnt disappear

* fix

* MK PR fixes 1

* Delete aggregation-expression-operators.txt

* remove mql

* fixes

* changes based on discussion

* MK PR fixes 2

* use cond in example

---------

Co-authored-by: Chris Cho <[email protected]>
Co-authored-by: DBirtolo-mdb <[email protected]>
Co-authored-by: Mike Woofter <[email protected]>
Co-authored-by: Mike Woofter <[email protected]>

* DOCSP-28586: How to use section (#341)

* first pass

* first pass fixes

* cssclass delete

* DB PR fixes 1

* MK PR fixes 1

* MK PR fixes 2

* DOCSP-28010: string operations (#342)

* DOCSP-28010: string operations

* CC PR fixes 1

* more small fixes

* link fix

* CC PR fixes 2

* MK PR fixes 1

* DOCSP-28007: date operations (#343)

* DOCSP-28007: date operations

* first pass fixes

* match format to string PR

* build

* DB PR fixes 1

* MK PR fixes 1

* MK PR fixes 2

* small fixes

* Docsp 28002 arithmetic operations (#344)

* DOCSP-28002: Adding arithmetic agg expressions

* Fixed a broken link

* PR feedback

* Additional PR feedback.

* Small grammar tweaks

* Updates to match established template.

* DOCSP-28003: Array Operations (#349)

* DOCSP-28003: array operations

* first pass fixes

* fix code block

* change text

* DB PR fixes 1

* small fixes

* add article

* missing methods & admonition

* MK PR fixes 1

* build

* MK PR fixes 2

* MK comment

* DOCSP-28005: Adding comparison agg operators (#345)

* DOCSP-28005: Adding comparison agg operators

* PR feedback

* Fixed link issues

* Updates to match established template.

* Maxim feedback

* Sample fix

* DOCSP-28808: conversion operations (#358)

* DOCSP-28808: conversion operations

* DB PR fixes 1

* Update aggregation-expression-operations.txt

* MK PR fixes 1

* DOCSP-28864: function (passTo) operations (#359)

* DOCSP-28864: passTo operations (misc)

* section draft1

* first pass fixes

* small fixes + explanation

* fix format

* DB PR fixes 1

* MK PR fixes 1

* renamed methods

* MK PR fixes 2

* build

* DOCSP-28006: Added conditional and set operations (#347)

* DOCSP-28006: Added conditional and set operations

* PR feedback.

* PR feedback part 2

* Grammar fix

* Added the swtich statement

* Trying to fix indentation

* Empty commit to prod the build tool.

* Forgot the  in the pipeline

* Changed how the switch variants are listed

* Maxim feedback

* DOCSP-28934: Cleaning up aggregation expressions (#361)

* DOCSP-28934: Cleaning up aggregation expressions

* build staging

* RR responding to MK PR comments

* build

* build

* small fixes

* RR responding to MK PR comments 2

* error fixes

* add queryapi for map ops

* PR comments

* more PR comments

* add descriptions to constructor methods

* grammar fix

* Maxim feedback on final review.

* Maxim feedback

* Build commit

* Maxim feedback part 2

* Removed empty 'More Information' section

* Removed excess comma from code example

---------

Co-authored-by: Mike Woofter <[email protected]>
Co-authored-by: Rea Rustagi <[email protected]>
Co-authored-by: DBirtolo-mdb <[email protected]>
Co-authored-by: Mike Woofter <[email protected]>
Co-authored-by: Rea Radhika Rustagi <[email protected]>
Co-authored-by: Dylan Birtolo <[email protected]>

Author: 4 people

.github/.backportrc.json

@@ -1,13 +1,17 @@
 {
   "repoOwner": "mongodb",
   "repoName": "docs-java",
-
-  "targetBranchChoices": ["master", "v4.9", "v4.8", "v4.7", "v4.6", "v4.5", "v4.4", "v4.3"],
+  "targetBranchChoices": [
+    "master",
+    "v4.9",
+    "v4.8",
+    "v4.7",
+    "v4.6",
+    "v4.5",
+    "v4.4",
+    "v4.3"
+  ],
 
   "autoMerge": true,
-  "autoMergeMethod": "squash",
-
-  "branchLabelMapping": {
-    "^auto-backport-to-(.+)$": "$1"
-  }
-}
+  "autoMergeMethod": "squash"
+}

snooty.toml

@@ -10,6 +10,7 @@ toc_landing_pages = [
     "/fundamentals/connection",
     "/fundamentals/crud",
     "/fundamentals/builders",
+    "/fundamentals/aggregation",
     "/usage-examples",
 ]
 sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
@@ -20,7 +21,6 @@ driver-long = "MongoDB Java Driver"
 version = "4.9"
 full-version = "{+version+}.1"
 mdb-server = "MongoDB server"
-
 package-name-org = "mongodb-org"
 api = "https://mongodb.github.io/mongo-java-driver/{+version+}"
 stable-api = "Stable API"

source/fundamentals.txt

@@ -17,6 +17,7 @@ Fundamentals
    /fundamentals/crud
    /fundamentals/builders
    /fundamentals/aggregation
+   /fundamentals/aggregation-expression-operations
    /fundamentals/indexes
    /fundamentals/collations
    /fundamentals/logging

source/fundamentals/aggregation-expression-operations.txt

@@ -2,8 +2,6 @@
 Aggregation
 ===========
 
-.. default-domain:: mongodb
-
 .. contents:: On this page
    :local:
    :backlinks: none

source/fundamentals/aggregation.txt

@@ -17,7 +17,10 @@ In this guide, you can learn how to use the `Aggregates <{+api+}/apidocs/mongodb
 class which provides static factory methods that build :manual:`aggregation pipeline
 stages </meta/aggregation-quick-reference/#stages>` in the MongoDB Java driver.
 
-For a more thorough introduction to Aggregation, see our :ref:`Aggregation guide <java-aggregation>`.
+To learn more about aggregation, see our :ref:`Aggregation guide
+<java-aggregation>`. To learn how to create expression operations with
+discoverable, typesafe Java methods to use in your aggregations, see
+:ref:`java-aggregation-expression-operations`.
 
 .. tip::
 

source/fundamentals/builders/aggregates.txt

@@ -1,3 +1,5 @@
+.. _fundamentals-documents:
+
 =========
 Documents
 =========

source/fundamentals/data-formats/documents.txt

@@ -8,6 +8,7 @@ Fundamentals section:
 - :doc:`Read from and Write to MongoDB </fundamentals/crud>`
 - :doc:`Simplify your Code with Builders </fundamentals/builders>`
 - :doc:`Transform your Data </fundamentals/aggregation>`
+- :doc:`Create Aggregation Expressions </fundamentals/aggregation-expression-operations>`
 - :doc:`Create Indexes to Speed Up Queries </fundamentals/indexes>`
 - :doc:`Sort Using Collations </fundamentals/collations>`
 - :doc:`Log Events in the Driver </fundamentals/logging>`

source/includes/fundamentals-sections.rst

@@ -166,4 +166,4 @@ Take the free online course taught by MongoDB instructors
 
      - `Using MongoDB with Java <https://learn.mongodb.com/learning-paths/using-mongodb-with-java>`_
 
-       Learn the essentials of Java application development with MongoDB.
+       Learn the essentials of Java application development with MongoDB.