[Suggestion]: remove the caveat for writing ref in render path

Summary

In the doc for ref https://react.dev/reference/react/useRef#caveats, it calls out to not read/write ref in rendering phase without a very clear "bad example"

Page

No response

Details

However, there is use case where the caller just needs a static ref at component level to wrap a dynamic value: for example, I need to read/write a static ref in rendering path (keep it in-sync with the current render context value)

In another word, the argument could be "a need to read/sync a "render context" value into a static variable attached to the functional component", + the "ref" value is not use in the "return" of the functional component

const { componentId, renderId } = useContext(componentContext);
const context = { componentId, renderId } <--- dynamic

const contextRef  =  useRef(context); <--- static
contextRef.current = context;

useQuery({
  context: contextRef  <--- static ref to avoid equal check, the ref value is only used for logging
})

e.g. https://github.com/apollographql/apollo-client/issues/11835

and there are popular library like useLatest implemented by writing ref in render path

Can we remove or update the caveat to make it more clear? E.g. adding

If you don't attempt to use the "mutable" ref in determining the function return, it is fine to use it to sync rendering context

https://react.dev/reference/react/useRef#caveats の useRef の注意事項セクションを確認し、その説明をレポート内でリンクされている Apollo Client の issue および useLatest の実装と比較してください。コンポーネントの返り値に影響を与えずにレンダリング中に同期される refs について、この注意事項を削除または改訂すべきかを明確にしたうえで、ドキュメントを更新し、更新後の文言が曖昧でないことを確認してください。