[Suggestion]: Section "Queueing a Series of State Updates": await in event handler cause immediate rerender

Summary

The documentation says here: "React waits until all code in the event handlers has run before processing your state updates"

This not the case when using await inside the handler!

Example

const [myNumber, setMyNumber] = useState(0);

async function handleClick(){
    setMyNumber(i => i + 1);
    await delay(100);
    setMyNumber(i => i + 1);
}

function delay(ms) {
    return new Promise(resolve => {
        setTimeout(resolve, ms);
    });
}

This will rerender the component twice!

Page

https://react.dev/learn/queueing-a-series-of-state-updates

Details

I suggest it should be mentioned as caveat/pitfall that if you call await inside an event handler,
all changes made to states before that await will then be flushed and trigger a rerender immediately, not waiting
for the event handler to finish completely.

阅读 issue 中链接的“Queueing a Series of State Updates”页面，并复现其中提供的异步事件处理器示例，以确认其行为。更新该页面，加入说明：await 之前的状态更新可能会在处理器完成之前 flush；当示例和批处理指导准确且清晰时，即视为完成。