urql-graphql / urql

The highly customizable and versatile GraphQL client with which you add on features like normalized caching as you grow.
https://urql.dev/goto/docs
MIT License
8.6k stars 448 forks source link

docs(graphcache): Update cache update docs #3334

Closed kitten closed 1 year ago

kitten commented 1 year ago

Summary

We have to clarify in our docs why cache updates may be written and when they can be avoided. This can trivially be done by explaining what cache updaters are for.

Additionally, while we now support partial, optimistic updaters, we don't actually clarify that this is possible in the docs, and instead state that it still isn't. The docs now state that we don't have to define all fields.

Set of changes