Skip to content

Commit 5714b04

Browse files
committed
Improve warnings and add to Fundamentals parts 1 and 5
1 parent ac4f4d8 commit 5714b04

File tree

3 files changed

+16
-16
lines changed

3 files changed

+16
-16
lines changed
+2-2
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
:::caution
22

3-
Note that **this tutorial intentionally shows older-style patterns that require more code than the "modern Redux" patterns we teach as the right approach for building apps with Redux today**, in order to explain the principles and concepts behind Redux. It's _not_ meant to be a production-ready project.
3+
Note that **this tutorial intentionally shows older-style Redux logic patterns that require more code than the "modern Redux" patterns with Redux Toolkit we teach as the right approach for building apps with Redux today**, in order to explain the principles and concepts behind Redux. It's _not_ meant to be a production-ready project.
44

55
See these pages to learn how to use "modern Redux" with Redux Toolkit:
66

7+
- [**The full "Redux Essentials" tutorial**](../tutorials/essentials/part-1-overview-concepts.md), which teaches "how to use Redux, the right way" with Redux Toolkit for real-world apps. **We recommend that all Redux learners should read the "Essentials" tutorial!**
78
- [**Redux Fundamentals, Part 8: Modern Redux with Redux Toolkit**](../tutorials/fundamentals/part-8-modern-redux.md), which shows how to convert the low-level examples from earlier sections into modern Redux Toolkit equivalents
8-
- [**The "Redux Essentials" tutorial**](../tutorials/essentials/part-1-overview-concepts.md), which teaches "how to use Redux, the right way" with Redux Toolkit for real-world apps,
99

1010
:::

docs/tutorials/fundamentals/part-1-overview.md

+4-14
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,9 @@ description: 'The official Fundamentals tutorial for Redux: learn the fundamenta
77

88
import { DetailedExplanation } from '../../components/DetailedExplanation'
99

10+
<!-- prettier-ignore -->
11+
import FundamentalsWarning from "../../components/_FundamentalsWarning.mdx";
12+
1013
# Redux Fundamentals, Part 1: Redux Overview
1114

1215
:::tip What You'll Learn
@@ -28,23 +31,10 @@ Starting in [Part 3: State, Actions, and Reducers](./part-3-state-actions-reduce
2831

2932
**This tutorial will teach you "how Redux works"**, as well as _why_ these patterns exist.
3033

31-
:::tip
32-
33-
Note that **this tutorial intentionally shows older-style patterns that require more code than the "modern Redux" patterns we teach as the right approach for building apps with Redux today**, in order to explain the principles and concepts behind Redux. **The initial code will be less concise than the way we suggest writing real app code**, but writing it out long-hand is the best way to learn.
34-
35-
:::
34+
<FundamentalsWarning />
3635

3736
Once you understand how everything fits together, we'll look at using Redux Toolkit to simplify things. **Redux Toolkit is the recommended way to build production apps with Redux**, and is built on all of the concepts that we will look at throughout this tutorial. Once you understand the core concepts covered here, you'll understand how to use Redux Toolkit more efficiently.
3837

39-
:::info
40-
41-
If you're looking to learn more about how Redux is used to write real-world applications, please see:
42-
43-
- [**The "Modern Redux" page in this tutorial**](./part-8-modern-redux.md), which shows how to convert the low-level examples from earlier sections into the modern patterns we do recommend for real-world usage
44-
- [**The "Redux Essentials" tutorial**](../essentials/part-1-overview-concepts.md), which teaches "how to use Redux, the right way" for real-world apps, using our latest recommended patterns and practices.
45-
46-
:::
47-
4838
We've tried to keep these explanations beginner-friendly, but we do need to make some assumptions about what you know already so that we can focus on explaining Redux itself. **This tutorial assumes that you know**:
4939

5040
:::important Prerequisites

docs/tutorials/fundamentals/part-5-ui-and-react.md

+10
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,16 @@ In [Part 4: Store](./part-4-store.md), we saw how to create a Redux store, dispa
2222

2323
In this section, we'll add a User Interface for our todo app. We'll see how Redux works with a UI layer overall, and we'll specifically cover how Redux works together with React.
2424

25+
:::caution
26+
27+
Note that **this page and all of the "Essentials" tutorial teach using [our modern React-Redux hooks API](https://react-redux.js.org/api/hooks)**. The old-style [`connect` API](https://react-redux.js.org/api/connect) still works, but today we want all Redux users using the hooks API.
28+
29+
Also, the other pages in this tutorial intentionally show older-style Redux logic patterns that require more code than the "modern Redux" patterns with Redux Toolkit we teach as the right approach for building apps with Redux today, in order to explain the principles and concepts behind Redux.
30+
31+
See [**the "Redux Essentials" tutorial**](../tutorials/essentials/part-1-overview-concepts.md) for full examples of "how to use Redux, the right way" with Redux Toolkit and React-Redux hooks for real-world apps.
32+
33+
:::
34+
2535
## Integrating Redux with a UI
2636

2737
Redux is a standalone JS library. As we've already seen, you can create and use a Redux store even if you don't have a user interface set up. This also means that **you can use Redux with any UI framework** (or even without _any_ UI framework), and use it on both client and server. You can write Redux apps with React, Vue, Angular, Ember, jQuery, or vanilla JavaScript.

0 commit comments

Comments
 (0)