Document using HTML dialog element

Modals/Dialogs are very common on the web. Now that the HTML dialog element has full cross-browser support it would be great to see documentation around how to use this in React as it is far from obvious. In the current docs it says "instead of exposing open() and close() methods on a Dialog component, pass an isOpen prop to it." Should people avoid using the showModal() function? Is it necessary to use portals when using a HTML dialog element?

Such a common UI task should be clearly documented.

<dialog> used to have some accessibility concerns but all of those have been addressed. It's now a much better option than implementing your own dialog. It has many accessibility features like 'inert' built-in.

No se nombra ningún archivo de documentación ni ninguna prueba. Empieza revisando las indicaciones actuales de la documentación de React citadas en el issue y, después, investiga cómo deberían usarse conjuntamente el HTML dialog element, showModal() y portals. Se considera terminado cuando la documentación de React explique claramente el enfoque recomendado y responda si showModal() y portals son necesarios.