A dialog provides an exchange of information, or dialog, between the user and the application. Use a dialog to obtain additional information from the user that is needed to carry out a particular command or task.
A dialog should not appear in the panel window list. Any open dialogs should be raised above the application when the application window itself is selected from the window list.

Name of command that opened the dialog (without any trailing ellipsis)
Minimize, Roll-up/Unroll
Follow the guidelines for Alert buttons, see Section 3.4.2 ― Alert Buttons.
Your dialog may specify a default button, that is activated when the user presses the Return key. See Section 3.3.3 ― Default Buttons for guidance on choosing an appropriate default button.
You can include other buttons in a dialog's main button area in addition to the affirmative button and Cancel, but any more than one or two such buttons will make the dialog appear complicated and difficult to use. As with any other button, keep the labels as concise as possible to minimize this effect.
A clean, logical dialog layout helps the user to quickly understand what information is required from them.
See Chapter 8 ― Visual Design for more detailed information on arranging controls in dialogs.
See Section 6.16 ― Tabbed Notebooks for information on using tabbed notebook controls in dialogs.
The gtk and GNOME libraries provide standard dialogs for many common tasks, including opening and saving files, choosing fonts and colors, and printing. Always use these when the user is performing one of these tasks. You may modify the dialogs to reflect the needs of your particular application (for example, adding preview Play and Stop buttons to the Open File dialog in an audio application), but do not change or remove features so much as to make them unrecognizable.