* Empty commit for v2 branch

* docs: add mutate filter functions documentation in v2

* remove the usage of cache.clear() and use mutate instead

* Empty commit for v2 branch

* docs: add preload API documentation in v2

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Update pages/docs/prefetching.en-US.md

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* apply suggestions to other languages

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Empty commit for v2 branch

* docs: add DevTools documentation in v2

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* apply suggestions to other languages

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Empty commit for v2 branch

* docs: Nesting configurations with SWRConfig

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Update pages/docs/global-configuration.en-US.md

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* apply suggestions to other languages

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Fetcher no longer accepts multiple arguments in v2

* Empty commit for v2 branch

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Update pages/docs/arguments.en-US.md

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* apply suggestions to other languages

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* docs: add an example for preload in effects

* Update pages/docs/prefetching.en-US.md

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* merge examples for inside React

* Update pages/docs/prefetching.en-US.md

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* apply a suggestion

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* docs: add the Return Values page

* docs: add isLoading and keepPreviousData option

* docs: fix header levels

* docs: add a video for keepPreviousData

* docs: move arguments page to next to return values page

* docs: update diagrams for returning values

* docs: update the performance document to add isLoading

* docs: keep the list of return values in the options document

* use isLoading instead of !data

* translate options.md into Japanese

* docs: add a detail link for keepPreviousData

* tweak the description of isLoading

* revert to move the arguments page

* move the return values page into the advanced section

* rename the Options page to API Options

* fix links to the return values

* fix a typo

* add an excalidraw file for the state machine diagrams

* rename the page from Return Values to Understanding SWR

* rename the Options page to API

* translate Understanding SWR into Japanese

* tweak

* change /docs/options links to /docs/api

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

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* change the link of Understanding SWR

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* reorganize the mutation page for useSWRMutation

* write paramters and return values sections for mutation

* docs: add examples of useSWRMutation

* add an exmple to use useSWRMutation for loading data

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Empty commit for v2 branch

* docs: add notes for Suspense on SSR and React v18

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* apply suggestions to other languages

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* update other language

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* sync the mutation page of other languages

* move the return values section of mutate into the API section

add a note for the shape of keys in mutate filter functions

* explicit the location of mutate

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* apply feedback to other languages

* add more descriptiong to mutation

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* add the v2 blog page

* update the description

* add the migration guide section

* write more section for what's new

* write changes of highlights

* add demo videos in the v2 blog and links to the CodeSandbox

* tweak

* add braking changes for mutate multiple items

* update description

* add isMutating into the example for useSWRMutation

* Apply suggestions from code review

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* Update pages/blog/swr-v2.en-US.mdx

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* move the details of isLoading and isValidating to the Userstanding SWR page

* tweak wording

* add authors

* add og image

Co-authored-by: Jiachi Liu <inbox@huozhi.im>

* sync the translation docs

* fix Author's link

* remove copy from a file name

* fix: the hook name of useSWRMutation example

* fix: optimisticData examples

add onDiscarded option

* blog improvements

* update

* update blog post

* update mutation

* update

docs: change the build target in the v2 blog

* Add functional rollbackOnError description

* fix typo

* docs: translate v2 updates into Japanese

* tweak

update card and description

* Rename laggy ui to preserving previous state

* fix