docs: add isLoading and keepPreviousData pages in v2

next.config.js

@@ -32,6 +32,11 @@ module.exports = withNextra({
         destination: "/docs/advanced/cache",
         statusCode: 301,
       },
+      {
+        source: "/docs/options",
+        destination: "/docs/api",
+        statusCode: 301
+      },
       {
         source: "/change-log",
         destination: "/docs/change-log",

pages/docs/advanced/meta.en-US.json

@@ -1,5 +1,5 @@
 {
-  "return-values": "Return Values",
+  "understanding-swr": "Understanding SWR",
   "cache": "Cache",
   "performance": "Performance",
   "react-native": "React Native",

pages/docs/advanced/meta.es-ES.json

@@ -1,5 +1,5 @@
 {
-  "return-values": "Valores devueltos",
+  "understanding-swr": "Understanding SWR",
   "cache": "Cache",
   "performance": "Rendimiento",
   "react-native": "React Native",

pages/docs/advanced/meta.ja.json

@@ -1,5 +1,5 @@
 {
-  "return-values": "返り値",
+  "understanding-swr": "Understanding SWR",
   "cache": "キャッシュ",
   "performance": "パフォーマンス",
   "react-native": "React Native",

pages/docs/advanced/meta.ko.json

@@ -1,5 +1,5 @@
 {
-  "return-values": "반환 값",
+  "understanding-swr": "Understanding SWR",
   "cache": "캐시",
   "performance": "성능",
   "react-native": "React Native",

pages/docs/advanced/meta.pt-BR.json

@@ -1,5 +1,5 @@
 {
-  "return-values": "Valores Retornados",
+  "understanding-swr": "Understanding SWR",
   "cache": "Cache",
   "performance": "Desempenho",
   "react-native": "React Native",

pages/docs/advanced/meta.ru.json

@@ -1,5 +1,5 @@
 {
-  "return-values": "Возвращаемые значения",
+  "understanding-swr": "Understanding SWR",
   "cache": "Кеш",
   "performance": "Производительность",
   "react-native": "React Native",

pages/docs/advanced/meta.zh-CN.json

@@ -1,5 +1,5 @@
 {
-  "return-values": "返回值",
+  "understanding-swr": "Understanding SWR",
   "cache": "缓存",
   "performance": "性能",
   "react-native": "React Native",

pages/docs/advanced/return-values.en-US.mdx → pages/docs/advanced/understanding-swr.en-US.mdx

@@ -1,46 +1,46 @@
 import Video from 'components/video'
 
-# Return Values
+# Understanding SWR
 
-## The Patterns of the Return Values
+## State Machine
 
 `useSWR` returns `data`, `error`, `isLoading`, and `isValidating` depending on the state of the `fetcher` function. This diagrams describe how SWR returns values in some scenarios.
 
 ### Fetch and Revalidate
 
 This pattern is to fetch data and revalidate it later.
 
-![A pattern for fetch and revalidate](/img/return-values/fetch-and-revalidate.svg)
+![A pattern for fetch and revalidate](/img/understanding-swr/fetch-and-revalidate.svg)
 
 ### Key Change
 
 This pattern is to fetch data and change the key and revalidate it later.
 
-![A pattern for key change](/img/return-values/key-change.svg)
+![A pattern for key change](/img/understanding-swr/key-change.svg)
 
 ### Key Change + Previous Data
 
 This pattern is to fetch data and change the key and revalidate it later with the `keepPreviousData` option.
 
-![A pattern for key change + previous data](/img/return-values/key-change-previous-data.svg)
+![A pattern for key change + previous data](/img/understanding-swr/key-change-previous-data.svg)
 
 ### Fallback
 
 This pattern is to fetch data and revalidate it later with fallback data.
 
-![A pattern for fallback](/img/return-values/fallback.svg)
+![A pattern for fallback](/img/understanding-swr/fallback.svg)
 
 ### Key Change + Fallback
 
 This pattern is to fetch data and change the key and revalidate it later with fallback data.
 
-![A pattern for key change + fallback](/img/return-values/key-change-fallback.svg)
+![A pattern for key change + fallback](/img/understanding-swr/key-change-fallback.svg)
 
 ### Key Change + Previous Data + Fallback
 
 This pattern is to fetch data and change the key and revalidate it later with the `keepPreviousData` option and fallback data.
 
-![A pattern for key change + previous data + fallback](/img/return-values/key-change-previous-data-fallback.svg)
+![A pattern for key change + previous data + fallback](/img/understanding-swr/key-change-previous-data-fallback.svg)
 
 ## Return previous data for better UX
 
@@ -81,4 +81,4 @@ With `keepPreviousData` enabled, you will still get the previous data even if yo
 
 ## Dependency Collection for performance
 
-SWR only updates the states that are used by a component. If you only use `data` in the component, SWR ignores the updates of other properties like `isValidating`, and `isLoading`. This reduces rendering counts a lot. More information can be found [here](/docs/advanced/performance#dependency-collection).
+SWR only triggers re-rendering when the states used in the component have been updated. If you only use `data` in the component, SWR ignores the updates of other properties like `isValidating`, and `isLoading`. This reduces rendering counts a lot. More information can be found [here](/docs/advanced/performance#dependency-collection).