DOCS-4980 integrate Java examples

Author: kay-kim

.gitignore

@@ -50,6 +50,7 @@ primer/source/includes/hash.rst
 primer/source/.static
 primer/source/*.rst
 primer/source/core/*.rst
+primer/source/includes/example*.txt
 primer/source/includes/driver-table.rst
 primer/source/includes/fact-installation-bind-ip-default-in-config.rst
 primer/source/includes/fact-installation-directories.rst
@@ -74,6 +75,7 @@ primer/source/images/*.png
 primer/source/images/*.rst
 primer/source/images/*.svg
 primer/source/includes/*.cpp
+primer/source/includes/*.java
 *.mo
 .stub
 primer/source/includes/table-linux-kernel-version-production.yaml

primer/config/build_conf.yaml

@@ -17,6 +17,8 @@ project:
       branched: false
     - name: cpp
       branched: false
+    - name: java
+      branched: false
 version:
   release: '2.6.1'
   branch: '2.6'
@@ -30,10 +32,9 @@ system:
         - 'intersphinx-local.yaml'
     - migrations:
         - 'primer-migrations-complex.yaml'
-        - 'primer-migrations-images.yaml'
         - 'primer-migrations-simple.yaml'
         - 'primer-migrations-cpp-examples.yaml'
-    - images: '/source/images/metadata.yaml'
+        - 'primer-migrations-java-examples.yaml'
 assets:
   - branch: master
     path: build/docs-tools
@@ -44,6 +45,9 @@ assets:
   - branch: master
     path: build/cpp-examples
     repository: https://github.com/mongodb/mongo-cxx-driver.git
+  - branch: master
+    path: build/java-examples
+    repository: https://github.com/mongodb/mongo-java-driver
 paths:
   output: 'build'
   source: 'source'

primer/config/primer-migrations-complex.yaml

@@ -12,8 +12,8 @@ transform:
 source: tutorial/install-mongodb-on-red-hat.txt
 target: tutorial/install-mongodb-on-red-hat.txt
 transform:
-  regex: ":doc:`default ports </reference/default-mongodb-port>`."
-  replace: ":manual:`default ports </reference/default-mongodb-port>`."
+  - regex: ":doc:`default ports </reference/default-mongodb-port>`."
+    replace: ":manual:`default ports </reference/default-mongodb-port>`."
 ---
 source: tutorial/install-mongodb-on-windows.txt
 target: tutorial/install-mongodb-on-windows.rst
@@ -30,11 +30,6 @@ transform:
   regex: ":doc:`(.*) <(/reference/configuration-options)>`"
   replace: ":manual:`\\1 <\\2>`"
 ---
-source: includes/steps-run-mongodb-on-windows.yaml
-transform:
-  regex: ":doc:"
-  replace: ":manual:"
----
 source: includes/steps-get-mongodb-for-windows.yaml
 transform:
   regex: ":doc:"
@@ -51,11 +46,23 @@ transform:
   replace: ":manual:"
 ---
 source: includes/steps-run-mongodb-on-linux.yaml
+truncate:
+   end-before: "# End-for-getting-started-guide"
+---
+source: includes/steps-run-mongodb-on-a-linux-distribution.yaml
+truncate:
+   end-before: "# End-for-getting-started-guide"
+---
+source: includes/steps-run-mongodb-on-debian.yaml
+truncate:
+   end-before: "# End-for-getting-started-guide"
+---
+source: includes/steps-run-mongodb-on-windows.yaml
 transform:
-  - regex: ":doc:`/tutorial/getting-started`"
-    replace: ":doc:`/client`"
-  - regex: ":doc:`/administration/production-notes`"
-    replace: ":manual:`Production Notes </administration/production-notes>`"
+  - regex: ":doc:"
+    replace: ":manual:"
+truncate:
+   end-before: "# End-for-getting-started-guide"
 ---
 source: includes/list-mongodb-org-packages.rst
 transform:

primer/config/primer-migrations-cpp-examples.yaml

@@ -5,12 +5,18 @@ truncate:
 ---
 source: build/cpp-examples/examples/mongocxx/aggregate.cpp
 target: includes/example-cpp-group-documents-by-a-field-and-calculate-count.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-group-documents-by-a-field-and-calculate-count"
    end-before: "// @end: cpp-group-documents-by-a-field-and-calculate-count"
 ---
 source: build/cpp-examples/examples/mongocxx/aggregate.cpp
 target: includes/example-cpp-filter-and-group-documents.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-filter-and-group-documents"
    end-before: "// @end: cpp-filter-and-group-documents"
@@ -22,6 +28,9 @@ truncate:
 ---
 source: build/cpp-examples/examples/mongocxx/create.cpp
 target: includes/example-cpp-insert-a-document.cpp
+transform: 
+  regex: "^    "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-insert-a-document"
    end-before: "// @end: cpp-insert-a-document"
@@ -33,12 +42,18 @@ truncate:
 ---
 source: build/cpp-examples/examples/mongocxx/index.cpp
 target: includes/example-cpp-single-field-index.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-single-field-index"
    end-before: "// @end: cpp-single-field-index"
 ---
 source: build/cpp-examples/examples/mongocxx/index.cpp
 target: includes/example-cpp-create-compound-index.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-create-compound-index"
    end-before: "// @end: cpp-create-compound-index"
@@ -50,54 +65,81 @@ truncate:
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-all.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-all"
    end-before: "// @end: cpp-query-all"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-top-level-field.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-top-level-field"
    end-before: "// @end: cpp-query-top-level-field"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-embedded-document.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-embedded-document"
    end-before: "// @end: cpp-query-embedded-document"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-field-in-array.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-field-in-array"
    end-before: "// @end: cpp-query-field-in-array"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-greater-than.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-greater-than"
    end-before: "// @end: cpp-query-greater-than"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-less-than.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-less-than"
    end-before: "// @end: cpp-query-less-than"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-logical-and.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-logical-and"
    end-before: "// @end: cpp-query-logical-and"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-logical-or.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-logical-or"
    end-before: "// @end: cpp-query-logical-or"
 ---
 source: build/cpp-examples/examples/mongocxx/query.cpp
 target: includes/example-cpp-query-sort.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-query-sort"
    end-before: "// @end: cpp-query-sort"
@@ -109,24 +151,36 @@ truncate:
 ---
 source: build/cpp-examples/examples/mongocxx/remove.cpp
 target: includes/example-cpp-remove-matching-documents.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-remove-matching-documents"
    end-before: "// @end: cpp-remove-matching-documents"
 ---
 source: build/cpp-examples/examples/mongocxx/remove.cpp
 target: includes/example-cpp-remove-justone.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-remove-justone"
    end-before: "// @end: cpp-remove-justone"
 ---
 source: build/cpp-examples/examples/mongocxx/remove.cpp
 target: includes/example-cpp-remove-all-documents.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-remove-all-documents"
    end-before: "// @end: cpp-remove-all-documents"
 ---
 source: build/cpp-examples/examples/mongocxx/remove.cpp
 target: includes/example-cpp-drop-collection.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-drop-collection"
    end-before: "// @end: cpp-drop-collection"
@@ -138,24 +192,36 @@ truncate:
 ---
 source: build/cpp-examples/examples/mongocxx/update.cpp
 target: includes/example-cpp-update-top-level-fields.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-update-top-level-fields"
    end-before: "// @end: cpp-update-top-level-fields"
 ---
 source: build/cpp-examples/examples/mongocxx/update.cpp
 target: includes/example-cpp-update-embedded-field.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-update-embedded-field"
    end-before: "// @end: cpp-update-embedded-field"
 ---
 source: build/cpp-examples/examples/mongocxx/update.cpp
 target: includes/example-cpp-update-multiple-documents.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-update-multiple-documents"
    end-before: "// @end: cpp-update-multiple-documents"
 ---
 source: build/cpp-examples/examples/mongocxx/update.cpp
 target: includes/example-cpp-replace-document.cpp
+transform: 
+  regex: "^        "
+  replace: ""
 truncate:
    start-after: "// @begin: cpp-replace-document"
    end-before: "// @end: cpp-replace-document"