You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
SWR’s "Understanding SWR" section contains crucial insights into its data-fetching behavior, cache management, revalidation patterns, and more. The article tells us what are to be expected from using this library and it helps preventing us from misusing the library which, many times, is the cause of bugs.
However, it is currently located under the Advanced section, which many newcomers may overlook or assume it only covers special use cases which they may not be interested.
Thoughts
Article "Understanding SWR" is relatively short so visitors should be able to finish reading in only few minutes.
It also has code examples and demos.
which, to some extent, convey the motivation of creating SWR (stale-while-revalidate) and how we can be benefited.
Thus, I believe it should be placed early to encourage visitors to read and comprehend.
Proposal
Move "Understanding SWR" from advanced to some where early in documentations such as after "Getting Started".
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
Introduction
SWR’s "Understanding SWR" section contains crucial insights into its data-fetching behavior, cache management, revalidation patterns, and more. The article tells us what are to be expected from using this library and it helps preventing us from misusing the library which, many times, is the cause of bugs.
However, it is currently located under the Advanced section, which many newcomers may overlook or assume it only covers special use cases which they may not be interested.
Thoughts
Thus, I believe it should be placed early to encourage visitors to read and comprehend.
Proposal
Move "Understanding SWR" from advanced to some where early in documentations such as after "Getting Started".
Beta Was this translation helpful? Give feedback.
All reactions