https://docs.avaloniaui.net/docs/reference/controls/window
compared with other controls , the window base control is a some-what "unique" control.
when I learn Avalonia, it took me a quite long time to find the docs about the Window class, such as show() and showdialog().
besides, non of avalonia samples and quick guide covers the Window control and its behaviors.
I suggests that we could create a new part what is linked to the window post in Controls Reference.
or create a more detailed one in "basics" part.