[Docs Rewrite] Create the new "Redux Fundamentals" tutorial (reduxjs#3894)

markerikson · web-flow · commit a629ca9e1e02 · 2020-11-01T23:52:39.000-05:00
Former-commit-id: 92d3eda Former-commit-id: 15bd6bf
diff --git a/README.md.REMOVED.git-id b/README.md.REMOVED.git-id
@@ -1 +1 @@
-2e2baf148540d48cc2a29658e455566c7e811d06
+0424fe6af6b783d33682bd735278062c19a86b36
diff --git a/docs/advanced/AsyncActions.md.REMOVED.git-id b/docs/advanced/AsyncActions.md.REMOVED.git-id
diff --git a/docs/advanced/AsyncFlow.md.REMOVED.git-id b/docs/advanced/AsyncFlow.md.REMOVED.git-id
diff --git a/docs/advanced/ExampleRedditAPI.md.REMOVED.git-id b/docs/advanced/ExampleRedditAPI.md.REMOVED.git-id
diff --git a/docs/advanced/Middleware.md.REMOVED.git-id b/docs/advanced/Middleware.md.REMOVED.git-id
diff --git a/docs/advanced/NextSteps.md.REMOVED.git-id b/docs/advanced/NextSteps.md.REMOVED.git-id
diff --git a/docs/advanced/README.md.REMOVED.git-id b/docs/advanced/README.md.REMOVED.git-id
diff --git a/docs/advanced/UsageWithReactRouter.md.REMOVED.git-id b/docs/advanced/UsageWithReactRouter.md.REMOVED.git-id
diff --git a/docs/basics/Actions.md.REMOVED.git-id b/docs/basics/Actions.md.REMOVED.git-id
diff --git a/docs/basics/DataFlow.md.REMOVED.git-id b/docs/basics/DataFlow.md.REMOVED.git-id
diff --git a/docs/basics/ExampleTodoList.md.REMOVED.git-id b/docs/basics/ExampleTodoList.md.REMOVED.git-id
diff --git a/docs/basics/README.md.REMOVED.git-id b/docs/basics/README.md.REMOVED.git-id
diff --git a/docs/basics/Reducers.md.REMOVED.git-id b/docs/basics/Reducers.md.REMOVED.git-id
diff --git a/docs/basics/Store.md.REMOVED.git-id b/docs/basics/Store.md.REMOVED.git-id
diff --git a/docs/basics/UsageWithReact.md.REMOVED.git-id b/docs/basics/UsageWithReact.md.REMOVED.git-id
diff --git a/docs/faq/Actions.md.REMOVED.git-id b/docs/faq/Actions.md.REMOVED.git-id
@@ -1 +1 @@
-8b7e3f5383ee6f75ceb0b38eba7edce6a141239a
+0e7c281202986ee83bd89d1e7629917ee7c0a3a6
diff --git a/docs/faq/General.md.REMOVED.git-id b/docs/faq/General.md.REMOVED.git-id
@@ -1 +1 @@
-e26ddf5af316cd0808d8616ae5ed51021189f46b
+282bc23b1f88a45523ce7d3ea9af3462b0c24a55
diff --git a/docs/faq/OrganizingState.md.REMOVED.git-id b/docs/faq/OrganizingState.md.REMOVED.git-id
@@ -1 +1 @@
-d75186ea830a2c00b62bdb1b1a8bc84d40a2c367
+3f6768c38c80e4198979f8ad1adb0501480052e3
diff --git a/docs/faq/Performance.md.REMOVED.git-id b/docs/faq/Performance.md.REMOVED.git-id
@@ -1 +1 @@
-f919b49e05c0335c6445739f5d6ccb0678f7c092
+3a1c78b42a1c2673fd480ad03a45728b91db184e
diff --git a/docs/faq/ReactRedux.md.REMOVED.git-id b/docs/faq/ReactRedux.md.REMOVED.git-id
@@ -1 +1 @@
-213c0c2c3eee51440e5a892071c59547a2619de9
+4f844af137392c23aea00a9d676e7cea85b5d026
diff --git a/docs/faq/Reducers.md.REMOVED.git-id b/docs/faq/Reducers.md.REMOVED.git-id
@@ -1 +1 @@
-a08f10aa6e5d289cbf1c180db615f89e2a62200f
+e6a6513ff9aa0ec5b7f3b06783d2a311f99ba50e
diff --git a/docs/faq/StoreSetup.md.REMOVED.git-id b/docs/faq/StoreSetup.md.REMOVED.git-id
@@ -1 +1 @@
-4cd1b8827eba48065f11c4eabf7600ec9231155e
+142112b27ae88ac06fc911ed82dc5d5c22e9f975
diff --git a/docs/introduction/GettingStarted.md.REMOVED.git-id b/docs/introduction/GettingStarted.md.REMOVED.git-id
@@ -1 +1 @@
-091eb6093f3a7e0d4d0f10745c36db456a6a6a93
+102f56351dacb8e21e84fa9dda45ea170917a5d6
diff --git a/docs/introduction/LearningResources.md.REMOVED.git-id b/docs/introduction/LearningResources.md.REMOVED.git-id
@@ -1 +1 @@
-d41ed054e8e95aba47099bc81af76de6a38106a7
+dcb311cb61ef8ed830eaade8519a761f20e1a9de
diff --git a/docs/recipes/ComputingDerivedData.md.REMOVED.git-id b/docs/recipes/ComputingDerivedData.md.REMOVED.git-id
@@ -1 +1 @@
-3f5c200080cbd8c9776cfe2dfb079b18b7ca401e
+671812713f2f65d1200d480cfb8108d79d4fba0b
diff --git a/docs/recipes/ConfiguringYourStore.md.REMOVED.git-id b/docs/recipes/ConfiguringYourStore.md.REMOVED.git-id
@@ -1 +1 @@
-b8e635ee2e2b7f2273b45310eecfe753988a6dfc
+c9ff06dd3822227984ec78916ccfe85f2afc4be0
diff --git a/docs/recipes/ImplementingUndoHistory.md.REMOVED.git-id b/docs/recipes/ImplementingUndoHistory.md.REMOVED.git-id
@@ -1 +1 @@
-9475dd8e14d4d2b1fb1fdf9efeaabd5bf701a173
+cef663b939ac701f11b14f66e0b18c7789b3ad71
diff --git a/docs/recipes/MigratingToRedux.md.REMOVED.git-id b/docs/recipes/MigratingToRedux.md.REMOVED.git-id
@@ -1 +1 @@
-1b64cece0b63546ef7509c06e4b4a38b80de1574
+9864563fa52f82c6f5ba31dddef9a10df24293d7
diff --git a/docs/recipes/README.md b/docs/recipes/README.md
@@ -6,7 +6,7 @@ hide_title: true
 
 # Recipes
 
-These are some use cases and code snippets to get you started with Redux in a real app. They assume you understand the topics in [basic](../basics/README.md) and [advanced](../advanced/README.md) tutorials.
+These are some use cases and code snippets to get you started with Redux in a real app. They assume you understand the topics in [the "Redux Fundamentals" tutorial](../tutorials/fundamentals/part-1-overview.md).
 
 - [Configuring Your Store](ConfiguringYourStore.md)
 - [Usage with TypeScript](UsageWithTypescript.md)
diff --git a/docs/recipes/ServerRendering.md.REMOVED.git-id b/docs/recipes/ServerRendering.md.REMOVED.git-id
@@ -1 +1 @@
-60705452bebe5e21610344c6af8f5a39ed94b1cd
+13f647879769fdd3145070273c2471c1c697fd14
diff --git a/docs/recipes/structuring-reducers/PrerequisiteConcepts.md.REMOVED.git-id b/docs/recipes/structuring-reducers/PrerequisiteConcepts.md.REMOVED.git-id
@@ -1 +1 @@
-52d91353d25be82ef43050cca919961eaebde49c
+2ffc11d177a8a17fe7ed7206bbbe457be325f650
diff --git a/docs/recipes/structuring-reducers/StructuringReducers.md.REMOVED.git-id b/docs/recipes/structuring-reducers/StructuringReducers.md.REMOVED.git-id
@@ -1 +1 @@
-229d57de087e7c37e351a665e0dfe0bc4194f11c
+033524102fc26d92473648ec327bdb85b3ee29d8
diff --git a/docs/tutorials/essentials/part-1-overview-concepts.md.REMOVED.git-id b/docs/tutorials/essentials/part-1-overview-concepts.md.REMOVED.git-id
@@ -1 +1 @@
-ab71658648f069fed02c8bf7ba3f7b3b48159b5b
+b7b8353e20a122a36e51419e66ce6b0d969be384
diff --git a/docs/tutorials/essentials/part-2-app-structure.md.REMOVED.git-id b/docs/tutorials/essentials/part-2-app-structure.md.REMOVED.git-id
@@ -1 +1 @@
-a1e656dc1edfa00830a85e6be6d5c7c79a1581b5
+264121b1fd85d011d265f1322f83ada7034fc8cb
diff --git a/docs/tutorials/essentials/part-3-data-flow.md.REMOVED.git-id b/docs/tutorials/essentials/part-3-data-flow.md.REMOVED.git-id
@@ -1 +1 @@
-8eab75af5794d66514b3a81b211da0e919627c69
+9b0a4cc4656f7add008373c9f5d0dbb85978a386
diff --git a/docs/tutorials/essentials/part-4-using-data.md.REMOVED.git-id b/docs/tutorials/essentials/part-4-using-data.md.REMOVED.git-id
@@ -1 +1 @@
-3a49e627e95eb7c06550d2e93c7d1e9ce02d27fe
+c78bec4b68f68746f22267fdc3ebbc6e375dfa22
diff --git a/docs/tutorials/essentials/part-5-async-logic.md.REMOVED.git-id b/docs/tutorials/essentials/part-5-async-logic.md.REMOVED.git-id
@@ -1 +1 @@
-8c3f3685d1fae7f20dc734e36301b42369e081f1
+f29fa64b81f5402b422664df3e19cfb901f53a8c
diff --git a/docs/tutorials/essentials/part-6-performance-normalization.md.REMOVED.git-id b/docs/tutorials/essentials/part-6-performance-normalization.md.REMOVED.git-id
@@ -1 +1 @@
-8664623c246483868feacaefafa21970088f821c
+95c13671e81540b976e09d4d7a5a30b045623e13
diff --git a/docs/tutorials/fundamentals/part-1-overview.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-1-overview.md.REMOVED.git-id
@@ -0,0 +1 @@
+bd7771722970ac49ef0a046087e20c92b64a0c39
diff --git a/docs/tutorials/fundamentals/part-2-concepts-data-flow.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-2-concepts-data-flow.md.REMOVED.git-id
@@ -0,0 +1 @@
+31925d6269893baacdcd2e2fab59e06ca07622bf
diff --git a/docs/tutorials/fundamentals/part-3-state-actions-reducers.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-3-state-actions-reducers.md.REMOVED.git-id
@@ -0,0 +1 @@
+49ecc5ecd405405732923fc2bfcb46ff7aced229
diff --git a/docs/tutorials/fundamentals/part-4-store.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-4-store.md.REMOVED.git-id
@@ -0,0 +1 @@
+0a0c7ec0efb9354df8d8c23db781390b4886f9e6
diff --git a/docs/tutorials/fundamentals/part-5-ui-and-react.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-5-ui-and-react.md.REMOVED.git-id
@@ -0,0 +1 @@
+704ca1c24560bbdc2f1515596ee5150019773be8
diff --git a/docs/tutorials/fundamentals/part-6-async-logic.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-6-async-logic.md.REMOVED.git-id
@@ -0,0 +1 @@
+913e3734f2b66202e147b6b6c698a495ddfe2639
diff --git a/docs/tutorials/fundamentals/part-7-standard-patterns.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-7-standard-patterns.md.REMOVED.git-id
@@ -0,0 +1 @@
+de2dfbe5e8809dc9fa54aa6f4dd039f785d15d75
diff --git a/docs/tutorials/fundamentals/part-8-modern-redux.md.REMOVED.git-id b/docs/tutorials/fundamentals/part-8-modern-redux.md.REMOVED.git-id
@@ -0,0 +1 @@
+e62fca9ae24002fbc133201a0d79426a74e9c409
diff --git a/docs/tutorials/tutorials-index.md b/docs/tutorials/tutorials-index.md
@@ -0,0 +1,21 @@
+---
+id: tutorials-index
+slug: index
+title: 'Redux Tutorials Index'
+sidebar_label: 'Tutorials Index'
+hide_title: true
+description: 'Overview of the Redux tutorial pages'
+---
+
+# Redux Tutorials Index
+
+We have two different sets of tutorials:
+
+- The [**Redux Essentials tutorial**](./essentials/part-1-overview-concepts) is a "top-down" tutorial that teaches "how to use Redux the right way", using our latest recommended APIs and best practices.
+- The [**Redux Fundamentals tutorial**](./fundamentals/part-1-overview.md) is a "bottom-up" tutorial that teaches "how Redux works" from first principles and without any abstractions, and why standard Redux usage patterns exist.
+
+:::tip
+
+**We recommend starting with the [Redux Essentials tutorial](./essentials/part-1-overview-concepts)**, since it covers the key points you need to know about how to get started using Redux to write actual applications.
+
+:::
diff --git a/docs/tutorials/tutorials-index.md.REMOVED.git-id b/docs/tutorials/tutorials-index.md.REMOVED.git-id
diff --git a/website/_redirects.REMOVED.git-id b/website/_redirects.REMOVED.git-id
@@ -1 +1 @@
-f30372243f37def103b1ebcf2d468a082600f584
+142583e9808b135ebfd31dab6cc0698e0104f5fe
diff --git a/website/docusaurus.config.js.REMOVED.git-id b/website/docusaurus.config.js.REMOVED.git-id
@@ -1 +1 @@
-16d1bfed7f064610c83992cb217d6a41e1a73a04
+4324e14797d85ae8129650b1480a47fa56179bfc
diff --git a/website/sidebars.js.REMOVED.git-id b/website/sidebars.js.REMOVED.git-id
@@ -1 +1 @@
-d0b8f3625a621ea977f58f411ec3372601074854
+ddb00eda69ba4d8a874d6a42b82d46f3d1b00261
diff --git a/website/src/css/custom.css.REMOVED.git-id b/website/src/css/custom.css.REMOVED.git-id
@@ -1 +1 @@
-90a1aa6c11de04bfbd5e8e9eba3c6c3fc8b0da82
+c5d1e84e12b7d34e075940b30bff20ba53eba03c
diff --git a/website/src/js/monokaiTheme.js.REMOVED.git-id b/website/src/js/monokaiTheme.js.REMOVED.git-id
@@ -1 +1 @@
-8b5ffb46b3f4cbeb5597e82260ac1cac722ba33f
+26b0a547c61fc9056592411d3719493ca66437a4
diff --git a/website/static/img/tutorials/essentials/ReduxAsyncDataFlowDiagram.gif.REMOVED.git-id b/website/static/img/tutorials/essentials/ReduxAsyncDataFlowDiagram.gif.REMOVED.git-id
@@ -0,0 +1 @@
+191caf09237a4226e87189621cc638e3af0eace9
diff --git a/website/static/img/tutorials/fundamentals/devtools-action-tab.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/devtools-action-tab.png.REMOVED.git-id
@@ -0,0 +1 @@
+4480db8649223c81af2fff17196ea64324895a28
diff --git a/website/static/img/tutorials/fundamentals/devtools-async-todoAdded-action.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/devtools-async-todoAdded-action.png.REMOVED.git-id
@@ -0,0 +1 @@
+33aa0c1283ceed77c14a05251445031e96bd3cfc
diff --git a/website/static/img/tutorials/fundamentals/devtools-async-todoAdded-diff.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/devtools-async-todoAdded-diff.png.REMOVED.git-id
@@ -0,0 +1 @@
+103ccb0749042072e09a897c54b53c9f5f5342ba
diff --git a/website/static/img/tutorials/fundamentals/devtools-diff-tab.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/devtools-diff-tab.png.REMOVED.git-id
@@ -0,0 +1 @@
+25ee76d0f0a0a41443fa606167c6479fc99f9464
diff --git a/website/static/img/tutorials/fundamentals/devtools-state-tab.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/devtools-state-tab.png.REMOVED.git-id
@@ -0,0 +1 @@
+21af4b56c5c063ef340b3ccd14b84f31bfe6ad41
diff --git a/website/static/img/tutorials/fundamentals/devtools-todosLoaded-action.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/devtools-todosLoaded-action.png.REMOVED.git-id
@@ -0,0 +1 @@
+8af101817beb7333cd5554121fc20b7275d1bb22
diff --git a/website/static/img/tutorials/fundamentals/immutable-error.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/immutable-error.png.REMOVED.git-id
@@ -0,0 +1 @@
+d2c87bbc86ad1c74214a7c2fe479c4899848627b
diff --git a/website/static/img/tutorials/fundamentals/initial-state-updates.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/initial-state-updates.png.REMOVED.git-id
@@ -0,0 +1 @@
+aebc890e854469918d58dbdb00f8cd6e1acd45e5
diff --git a/website/static/img/tutorials/fundamentals/meaningOfLife-enhancer-logging.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/meaningOfLife-enhancer-logging.png.REMOVED.git-id
@@ -0,0 +1 @@
+ab76c17c27bcd32841098afa66356a07925c1587
diff --git a/website/static/img/tutorials/fundamentals/print-middleware-logging.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/print-middleware-logging.png.REMOVED.git-id
@@ -0,0 +1 @@
+81a04ecbfdcff534bf659028dba8ae1e9a250a68
diff --git a/website/static/img/tutorials/fundamentals/sayhi-enhancer-logging.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/sayhi-enhancer-logging.png.REMOVED.git-id
@@ -0,0 +1 @@
+d813ec97dd3a8af86921dedc70848604f7ccf2c9
diff --git a/website/static/img/tutorials/fundamentals/todos-app-headerLoading.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/todos-app-headerLoading.png.REMOVED.git-id
@@ -0,0 +1 @@
+aabaa1a7982379b0e0c6fa5b9cd76bf596460d0c
diff --git a/website/static/img/tutorials/fundamentals/todos-app-markedCompleted.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/todos-app-markedCompleted.png.REMOVED.git-id
@@ -0,0 +1 @@
+effe0debf799fa067c1c96f6deaf2bcdc1de79fa
diff --git a/website/static/img/tutorials/fundamentals/todos-app-screenshot.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/todos-app-screenshot.png.REMOVED.git-id
@@ -0,0 +1 @@
+0bbec220109ea255f3a9cb4daa501175e9b44d0f
diff --git a/website/static/img/tutorials/fundamentals/todos-app-selectorFilters.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/todos-app-selectorFilters.png.REMOVED.git-id
@@ -0,0 +1 @@
+6c289a93a91fe1da41e04e3934af58d00f7cf630
diff --git a/website/static/img/tutorials/fundamentals/todos-app-showCompleted.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/todos-app-showCompleted.png.REMOVED.git-id
@@ -0,0 +1 @@
+68a57d1018beabcd00f047ec44bb0cbadfd701ed
diff --git a/website/static/img/tutorials/fundamentals/todos-app-todosLoaded.png.REMOVED.git-id b/website/static/img/tutorials/fundamentals/todos-app-todosLoaded.png.REMOVED.git-id
@@ -0,0 +1 @@
+8e86424ea13be4d6af69f19a723e8fb54e845054

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-2e2baf148540d48cc2a29658e455566c7e811d06`
	`1`	`+0424fe6af6b783d33682bd735278062c19a86b36`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-8b7e3f5383ee6f75ceb0b38eba7edce6a141239a`
	`1`	`+0e7c281202986ee83bd89d1e7629917ee7c0a3a6`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-e26ddf5af316cd0808d8616ae5ed51021189f46b`
	`1`	`+282bc23b1f88a45523ce7d3ea9af3462b0c24a55`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-d75186ea830a2c00b62bdb1b1a8bc84d40a2c367`
	`1`	`+3f6768c38c80e4198979f8ad1adb0501480052e3`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-f919b49e05c0335c6445739f5d6ccb0678f7c092`
	`1`	`+3a1c78b42a1c2673fd480ad03a45728b91db184e`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-213c0c2c3eee51440e5a892071c59547a2619de9`
	`1`	`+4f844af137392c23aea00a9d676e7cea85b5d026`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-a08f10aa6e5d289cbf1c180db615f89e2a62200f`
	`1`	`+e6a6513ff9aa0ec5b7f3b06783d2a311f99ba50e`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-4cd1b8827eba48065f11c4eabf7600ec9231155e`
	`1`	`+142112b27ae88ac06fc911ed82dc5d5c22e9f975`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-091eb6093f3a7e0d4d0f10745c36db456a6a6a93`
	`1`	`+102f56351dacb8e21e84fa9dda45ea170917a5d6`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-d41ed054e8e95aba47099bc81af76de6a38106a7`
	`1`	`+dcb311cb61ef8ed830eaade8519a761f20e1a9de`