From b0990a8ff99575a2395063f062633e5f5daa6496 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yann=20C=C3=A9bron?= <yann.cebron@jetbrains.com>
Date: Thu, 20 May 2021 12:01:39 +0200
Subject: [PATCH] dialog_wrapper.md: structure

---
 topics/user_interface_components/dialog_wrapper.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/topics/user_interface_components/dialog_wrapper.md b/topics/user_interface_components/dialog_wrapper.md
index f1126405b..dc91ed444 100644
--- a/topics/user_interface_components/dialog_wrapper.md
+++ b/topics/user_interface_components/dialog_wrapper.md
@@ -17,12 +17,14 @@ It provides the following features:
     * <shortcut>Left/Right</shortcut> for switching between buttons
     * <shortcut>Y</shortcut>/<shortcut>N</shortcut> for <control>Yes</control>/<control>No</control> actions if they exist in the dialog
 * Optional <control>Do not ask again</control> checkbox
+                                    
+### Usage
 
 When using the [`DialogWrapper`](upsource:///platform/platform-api/src/com/intellij/openapi/ui/DialogWrapper.java) class for a dialog, follow these steps:
 
-* Call the base class constructor and provide either a project in the frame of which the dialog will be displayed, or a parent component for the dialog.
+* Call the base class constructor and provide either a `Project` in the frame of which the dialog will be displayed, or a parent component for the dialog.
 * Call the `init()` method from the constructor of the dialog class
-* Call the `setTitle()` method to set the title for the dialog box
+* Call the `setTitle()` method to set the title for the dialog
 * Implement the `createCenterPanel()` method to return the component comprising the main contents of the dialog.
 
 * *Optional*: Override the `getPreferredFocusedComponent()` method and return the component that should be focused when the dialog is first displayed.
@@ -44,6 +46,8 @@ To customize the buttons displayed in the dialog (replacing the standard <contro
 Both of these methods return an array of Swing Action objects.
 If a button closes the dialog, use [`DialogWrapperExitAction`](upsource:///platform/platform-api/src/com/intellij/openapi/ui/DialogWrapper.java) as the base class for the action.
 Use `action.putValue(DialogWrapper.DEFAULT_ACTION, true)` to set the default button.
+         
+### Input Validation
 
 To validate the data entered into the dialog, override the `doValidate()` method.
 The method will be called automatically by timer.