Skip to content

Commit 6994c92

Browse files
markeriksonmarkerikson
authored
Create the Redux Essentials page, take 2 (reduxjs#3740)
* Port admonition and code block CSS from RTK site * Restructure sidebars to add "Tutorials" section * Add empty "Quick Start" tutorial page * Bump Docusaurus to alpha.48 * Fix text color in admonitions * Add blockquote styling for other pages * Add DetailedExplanation component * Initial Quick Start intro content * Quick Start: add "What is Redux" and "Terms" sections * Quick Start: add "play with app" content * Quick Start: create nested folder and rename file * Store setup * Quick Start: add slice, reducer, immutability, and thunk sections * Quick start: Add React-Redux section * Quick start: emphasize immutability, highlight JSX * Tweak "know more?" and explanation styles * Fix typo and add thunk usage mention * Bump Docusaurus to alpha.50 * Temporarily rename files to .md to work around DS bug See facebook/docusaurus#2551 * Add border color for highlight lines * Add code block titles and test line highlights * Initial project setup section * Add reducer and data flow explanations * Tweak wording * Link example repo and sandbox * Update Docusaurus * Fill out "Basic Data Flow" page * Add additional phrasing * Add intro and summary content for part 3 * Shrink code block file header padding * Finish writing Part 3 * Link to Immer docs * Add initial Part 4 content * Finish Quick Start part 4 * Remove unnecessary uses of "just" * Add Part 5 outline * Update page titles * Half of part 5 * Finish Quick Start content. Yay!!!!!! * Clean up tutorial part 1 based on review feedback - Reworded several explanations - Added "Immutability" section under "concepts" - Added data flow diagram - Removed leftover example code block * Add "What You've Learned" to part 1 * Rename part 5 -> 6 * Rename part 4 -> 5 * Rename part 3 -> 4 * Rename part 2 -> 3 * Add new Part 2 * Fix up TODO comments and broken links * Swap to new dataflow diagram * Assorted edits and link fixes * Rename "Quick Start" to "Redux Essentials" * Fix links and rename images * Update example app repo/sandbox links * Clarify random seed behavior * Rework introduction content - Redid "Getting Started" page by moving RTK first and removing most of the external tutorial links, - Added RTK to "Installation" page - Added description and "Best Practices" phrase to style guide - Added external links to prereq concepts - Fixed one-way data flow image - Added "Tutorial" link to header/footer, pointing to Essentials * Remove unwanted colors from pagination buttons * Emphasize recommended tutorial * Clean up README * Fix PR preview redirect * Clarify "smallest amount" wording * Try to fix redirects Former-commit-id: af8c8ea Former-commit-id: 35b5bcf
1 parent 81c5dc4 commit 6994c92

33 files changed

+47
-9
lines changed

‎README.md.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
c6206af164afffc7f7cc75f060a2329fcb8d213c
1+
06c2c8fd1f8d1d3e11232d26f91223eccec1d8f3

‎docs/components/DetailedExplanation.jsx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
import React from 'react'
2+
3+
export const DetailedExplanation = ({
4+
children,
5+
title = 'Detailed Explanation'
6+
}) => {
7+
return (
8+
<details className="detailed-explanation">
9+
<summary>
10+
<h4>{title}</h4>
11+
</summary>
12+
{children}
13+
</details>
14+
)
15+
}

‎docs/introduction/GettingStarted.md.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
c1009f22843241280a4c6e9a9064536491e11266
1+
73670ac005460e36ca5978f3a82499a22bffc84a

‎docs/introduction/Installation.md.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
9a0017b53b19e15dcf346faf55b9eca8f1fcaed2
1+
e18271509fdf3a5771c2670375b4f44a1fa519fa

‎docs/style-guide/style-guide.md.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
a0c4ec513de343fe7c98730e3b0fdd21b4b088ef
1+
d626d6f8aad44259d58ad4e5ade603beaa539c1d

‎docs/tutorials/essentials/part-1-overview-concepts.md.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
a4df5f1f297652579e324e960d423e8e9faccb7d

‎docs/tutorials/essentials/part-2-app-structure.md.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
4ad20f607ad7d35a63efbfa3bf75682b9f12f83a

‎docs/tutorials/essentials/part-3-data-flow.md.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
9e5e5f39071f0105c5fea3cdfe1bde6ced91e665

‎docs/tutorials/essentials/part-4-using-data.md.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
f9216d2a79b0c05ee2ebfecbdcf786c786b680ca

‎docs/tutorials/essentials/part-5-async-logic.md.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
fd931e4cc77ef0873cf2616f67470c9dc34fb93c

‎docs/tutorials/essentials/part-6-performance-normalization.md.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
e90eca8cefc46ad15cd427e86c450e8053756ac9

‎docs/tutorials/tutorials-index.md.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
77fb0aaa364ae2cc2c58a0dd06c80635f384456d

‎netlify.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
[build]
22
base = "website"
33
publish = "website/build"
4-
command = "npm run build"
4+
command = "npm run build && cp _redirects ./build"

‎website/_redirects.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
264d61e663e772ec5e15704bcb7223de2694e923
1+
52175f9b303200d7f9a2942b11f405b53a3570d5

‎website/docusaurus.config.js.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
c483a00546945661737c702f2b4420fe66c250f6
1+
5f8820176eae6edb7c518fc1515d564cfbcd8d88

‎website/sidebars.js.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
f08ecb0b8d0f749b5c326c43303c2b9abba6d4dc
1+
171dc4fb21576f51b8025b74c42f0cd5f70109e5

‎website/src/css/custom.css.REMOVED.git-id

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
f55a3b29c7d041743b807e840bc55a59d141b930
1+
52d1a5e8aa62637c2360b892ad7ac37595ad73a6

‎website/static/img/tutorials/essentials/ReduxDataFlowDiagram.gif.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
1960d04496daa72c9cfe37315fdeaed5f80e72b0

‎website/static/img/tutorials/essentials/devtools-done-clicking.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
5e5d405f709b53ba0e105e8cf91b310c1b2bd0c1

‎website/static/img/tutorials/essentials/devtools-first-action.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
7be869667b0198178501aaeeb936a70512c63800

‎website/static/img/tutorials/essentials/devtools-initial.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
088138480a88c76ec45b2fb85550633019aae409

‎website/static/img/tutorials/essentials/devtools-posts-fulfilled.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
e75c221535eeb86f9c1cca9f03f7ad24c788729c

‎website/static/img/tutorials/essentials/devtools-posts-pending.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
bc331533459bee46bc45af55cd1d6fad1b408908

‎website/static/img/tutorials/essentials/example-initial-posts-list.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
677efdff0fb008dcefc79742bf056782c30a7c07

‎website/static/img/tutorials/essentials/example-initial-posts.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
72ca72046a0136575d3293117965893773302078

‎website/static/img/tutorials/essentials/example-postAdded-action.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
124d54cff880f8042d64187eacf549a1e4227925

‎website/static/img/tutorials/essentials/notifications-initial.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
965bdb26a864418447ca854bfb59918568b99ba0

‎website/static/img/tutorials/essentials/notifications-new.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
376e2e6f54c7337b09b2f07370b785730d288d13

‎website/static/img/tutorials/essentials/one-way-data-flow.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
8a18b59cfef504c0549154a17f369cb3e3671b38

‎website/static/img/tutorials/essentials/posts-unknownAuthor.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
d4701ae8ccf910a89c8b334203fe01dc7f907477

‎website/static/img/tutorials/essentials/postslist-optimized.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
6427298f4dedc840d46ca9dd801c0f5f44539cbc

‎website/static/img/tutorials/essentials/postslist-rerender.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
973d54c8b9ea648bf2914620eb88d66eced0095f

‎website/static/img/tutorials/essentials/userpage-rerender.png.REMOVED.git-id

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
cb77d356f7fb4815778a14b74a505b6c1e0799a9

0 commit comments

Comments
 (0)