Revamp useOptimistic docs

[rickhanlonii]

Preview

Fixes #7737
Fixes #7379
Fixes #7098
Fixes #6926

[github-actions]

Size changes

Details

📦 Next.js Bundle Analysis for react-dev

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

[gaearon]

added some initial nits. examples add a lot of clarity, so great work on those. i'd just slightly trim everything and focus it down so each part explains one aspect

[stephan-noel]

Looks like a really nice improvement. Just some small nits and questions, but didn't get to the Usage section yet. Will have more in depth look at that later if it's still open to try to give more meaningful feedback.

[gaearon]

This feels confusing. The section starts with “you can call the optimistic setter directly without startTransition” but the example does have startTransition. I know it’s for an unrelated reason but is it possible to disambiguate or simplify the example? Or to explain what this is about.

[stephan-noel]

This feels confusing. The section starts with “you can call the optimistic setter directly without startTransition” but the example does have startTransition. I know it’s for an unrelated reason but is it possible to disambiguate or simplify the example? Or to explain what this is about.

True. Related thread here #8264 (comment).