[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

Xem lại phần lưu ý về useRef tại https://react.dev/reference/react/useRef#caveats và so sánh hướng dẫn trong đó với issue của Apollo Client và phần triển khai useLatest được liên kết trong báo cáo. Làm rõ liệu có nên loại bỏ hay sửa đổi lưu ý này đối với các refs được đồng bộ trong quá trình render mà không ảnh hưởng đến giá trị trả về của component hay không, sau đó cập nhật tài liệu và xác minh rằng cách diễn đạt sau cùng là rõ ràng, không gây hiểu nhầm.