Merge data modeling refactor changes (Phase 1) (#5638) (#5651) (#5652)

* DOCSP-28606 Data modeling concept page (#2874)

* change IA and add redirect

* remove old intro page

* add TOC

* fix toc tree

* WIP

* WIP

* WIP

* update intro

* structure improvements

* more edits

* fix build error

* edits

* edits

* structure shuffles

* clarity

* tweak Indexes section

* edits

* edits

* address review comments

* fix build error

* add table widths

* simplify wording

* typo fix

* address review comments

* review feedback in progress

* add text

* flesh out consistency and duplication section

* wording

* reorg

* typo

* reorg

* add clarification for duplication

* wording

* minimalism

* wording

* DOCSP-28607 Embedding vs References (#3137)

* change IA and add redirect

* remove old intro page

* add TOC

* fix toc tree

* WIP

* WIP

* WIP

* update intro

* structure improvements

* more edits

* fix build error

* edits

* edits

* structure shuffles

* clarity

* tweak Indexes section

* edits

* edits

* address review comments

* fix build error

* add table widths

* simplify wording

* typo fix

* initial page set up

* embedded data models section

* remove old page

* wording

* minimalism

* first draft complete

* add headings

* wording

* wording

* wording

* edits

* wording

* clarity

* reorder

* add redirects

* wording

* address review feedback

* fix build error and move page

* address review comments

* review feedback in progress

* add text

* flesh out consistency and duplication section

* wording

* reorg

* typo

* reorg

* add clarification for duplication

* wording

* minimalism

* address review feedback

* wording

* wording

* wording

* fix redirect

* fix redirect pt 2

* update ref link

* typo fix

* update toc

* fix build error (#3920)

* DOCSP-28608: Handle duplicate data (#3632)

* add initial page

* first draft

* WIP

* fix table width

* edits

* table widths

* table widths

* second draft

* wording

* formatting

* wording

* WIP review edits

* re-add subset example

* wording

* add id field

* edits

* review feedback

* formatting fix

* align with task template

* table widths

* dedent insert commands

* (DOCSP-28610): Schema Design Process (#4160)

* initial toc setup

* add new page to toc

* fix page title

* (DOCSP-28610): First draft

* edit casing

* add use cases

* add Learn More

* remove Learn More

* address review feedback

* change step style

* add more context per external review

* (DOCSP-28611): Identify workload task page (#4448)

* initial toc setup

* add new page to toc

* fix page title

* (DOCSP-28610): First draft

* edit casing

* add use cases

* add Learn More

* remove Learn More

* address review feedback

* change step style

* (DOCSP-28611): Identify workload task page

* add more details

* wording

* wording

* edits

* line space

* edit

* fix table heading

* change step title

* typo

* this > the

* (DOCSP-28612): Map relationships (#4509)

* initial toc setup

* add new page to toc

* fix page title

* (DOCSP-28610): First draft

* edit casing

* add use cases

* add Learn More

* remove Learn More

* address review feedback

* change step style

* (DOCSP-28612): Map relationships

* tweak intro

* typo

* wording

* wording

* remove period

* typo

* wording

* add context

* typo and wording fix

* minimalism

* wording

* edits

* add more details to example

* remove comma

* wording

* wording

* add line highlight

* change field value

* change field value

* tweak example field to use id

* wording

* minimalism

* address Sarah's review feedback

* change Learn More link

* add more context

* typo

* minimalism

* wrap at 72 chars

* remove quotes around field value

* present tense

* minimalism and typo

* remaining review comments

* add more context per external review

---------

* DOCSP-28609: Enforce data consistency (#3868)

* initial page setup

* WIP

* edit

* intro paragraph

* first draft of about this task

* add Before you Begin

* WIP steps

* first draft of Steps

* reorder

* typo

* start example

* more example

* typo

* finish example

* formatting

* add more context

* more edits

* add context for consistency approaches in table

* table widths

* minimalism

* remove implementation column

* add more context for performance impact

* typo

* wording

* review feedback

* reorg

* build error

* page title

* change page title and update snooty.toml

* typo (#4606)

* (DOCSP-33063): Enforce data consistency with transactions (#4602)

* (DOCSP-33063): Enforce data consistency with transactions

* edits

* Example > Steps

* minimalism

* remove extra blank line

* in-progress review edits

* Retry commit

* DOCSP-31878 Model 1:1 Relationship w/ Embedded docs refactor (#4611)

* DOCSP-31878 one to one

* DOCSP-31878 fixing example

* DOCSP-31878 internal feedback

* DOCSP-31878 nit fix

* DOCSP-31878 internalfeedback

* DOCSP-31878 add use case

* DOCSP-31879 One-to-Many Relationships with Embedded Documents Refactor (#4740)

* DOCSP-31879 refactor

* DOCSP-31879 update use case

* DOCSP-31879 jeff feedback

* (DOCSP-33156): Mention Atlas triggers on data consistency page (#5185)

* (DOCSP-33156): Enforce consistency with change streams

* WIP

* WIP

* formatting

* WIP

* (DOCSP-33156): Mention Atlas triggers on data consistency page

* fix subpages

* remove change streams page

* wording

* DOCSP-28613 Apply design patterns (#5086)

* WIP

* first draft

* edits

* edits

* wording

* syntax fix

* wording

* address review feedback

* review edits

* wording

* review edits

* formatting

* formatting

* add line highlights

* fix line highlight

* (DOCSP-28618): Group data landing page (#5130)

* (DOCSP-28618): Group data landing page

* fix build error

* update toc

* minimalism and formatting

* add subpages

* typo

* update snooty.toml

* edit intro

* edit intro

* nit

* Apply suggestions from code review

* wording

* change example

* edits

* edits

* consistency

* wording

---------

* (DOCSP-33779): Group data with the bucket pattern (#5273)

* (DOCSP-28618): Group data landing page

* fix build error

* update toc

* minimalism and formatting

* add subpages

* typo

* update snooty.toml

* edit intro

* edit intro

* nit

* WIP

* Apply suggestions from code review

* wording

* (DOCSP-33779): Bucket pattern

* edit

* edits

* tweak

* edits

* edit example

* edit step title

* clarification

* formatting

* add tip box

* minimalism

* consistency

* nits

* WIP review edits

* finish review edits

* change step style

* typo

* fix glossary link

* change example

* edits

* edits

* consistency

* wording

* WIP

* WIP

* WIP

* edits

* change id

* typo

* change id

* clarity

* add linenos

* add drop command

* fix insertMany

* clarity

* clarity

* add highlights

* add note

* add results

* final first draft

* edit

* tweak

* update toc depth

* WIP review edits

* address review comments

* wording

* formatting

* address review feedback

* typo

* reorg

---------

* DOCSP-33780 Group data with the outlier pattern (#5383)

* (DOCSP-28618): Group data landing page

* fix build error

* update toc

* minimalism and formatting

* add subpages

* typo

* update snooty.toml

* edit intro

* edit intro

* nit

* Apply suggestions from code review

* wording

* WIP

* WIP

* restore bucket file changes

* first draft

* more edits

* edits

* fix formatting

* fix collection name

* review edits

* wording

* typo

* minimalism

* address review feedback

* formatting

* review feedback

---------

* (DOCSP-34086): Enforce consistency with embedded documents (#5386)

* WIP

* build error

* fix link

* add task

* change txns link

* wording

* fix replacement

* wording

* minimalism

* change collection name

* Fix code formatting

* add Learn More link

* add next steps

* address review feedback

* update example to include ids

* typo

* fix build error

* fix links on landing page

* typo

* design patterns landing page

* add more context for map relationships step

* wording

* add redirects

---------

Co-authored-by: Jeff Allen <[email protected]>
Co-authored-by: jocelyn-mendez1 <[email protected]>
Co-authored-by: Sarah Olson <[email protected]>

Author: 4 people

config/redirects

@@ -1,7 +1,7 @@
 define: prefix docs
 define: base https://www.mongodb.com/${prefix}
-define: versions v2.2 v2.4 v2.6 v3.0 v3.2 v3.4 v3.6 v4.0 v4.2 v4.4 v5.0 v5.1 v5.2 v5.3 v6.0 v6.1 v6.2 v6.3 v7.0 master
-symlink: master -> v7.0
+define: versions v2.2 v2.4 v2.6 v3.0 v3.2 v3.4 v3.6 v4.0 v4.2 v4.4 v5.0 v5.1 v5.2 v5.3 v6.0 v6.1 v6.2 v6.3 v7.0 v7.1 v7.2 master
+symlink: master -> v7.2
 symlink: stable -> v7.0
 symlink: rapid -> v6.3
 symlink: current -> v7.0
@@ -2556,3 +2556,20 @@ raw: https://mongodb.github.io/mongo-java-driver/ -> ${base}/drivers/java/sync/c
 
 # DOCSP-31653
 [v7.0-*]: ${prefix}/${version}/reference/aggregation-quick-reference/ -> ${base}/${version}/reference/aggregation/
+
+# Data modeling refactor redirects
+[*-v7.1]: ${prefix}/${version}/data-modeling/embedding-vs-references -> ${base}/${version}/core/data-model-design
+[*-v7.1]: ${prefix}/${version}/data-modeling/data-consistency -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/design-patterns -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/design-patterns/group-data -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/design-patterns/group-data/bucket-pattern -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/design-patterns/group-data/outlier-pattern -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/enforce-consistency/embed-data -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/enforce-consistency/transactions -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/handle-duplicate-data -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/schema-design-process -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/schema-design-process/apply-patterns -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/schema-design-process/identify-workload -> ${base}/${version}/core/data-modeling-introduction
+[*-v7.1]: ${prefix}/${version}/data-modeling/schema-design-process/map-relationships -> ${base}/${version}/core/data-modeling-introduction
+[v7.2-*]: ${prefix}/${version}/core/data-modeling-introduction -> ${base}/${version}/data-modeling
+[v7.2-*]: ${prefix}/${version}/core/data-model-design -> ${base}/${version}/data-modeling/embedding-vs-references

snooty.toml

@@ -111,6 +111,11 @@ toc_landing_pages = [
    "/core/zone-sharding",
    "/core/zone-sharding",
    "/crud",
+   "/data-modeling",
+   "/data-modeling/schema-design-process",
+   "/data-modeling/data-consistency",
+   "/data-modeling/design-patterns",
+   "/data-modeling/design-patterns/group-data",
    "/geospatial-queries",
    "/indexes",
    "/installation",

source/administration/production-checklist-development.txt

@@ -36,7 +36,7 @@ Data in MongoDB has a *dynamic schema*. :term:`Collections
 <collection>` do not enforce :term:`document` structure. This
 facilitates iterative development and polymorphism. Nevertheless,
 collections often hold documents with highly homogeneous
-structures. See :doc:`/core/data-models` for more information.
+structures. For more information, see :ref:`manual-data-modeling-intro`.
 
 - Determine the set of collections that you will need and the
   indexes required to support your queries. With the exception of

source/applications/data-models-applications.txt

@@ -1,3 +1,5 @@
+.. _data-models-application-context:
+
 ===================================
 Model Specific Application Contexts
 ===================================

source/applications/data-models-tree-structures.txt

@@ -1,3 +1,5 @@
+.. _data-model-tree-structure:
+
 =====================
 Model Tree Structures
 =====================