Apply suggestions from code review

Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com>

Author: NickVolynkin

README.md

@@ -8,7 +8,8 @@
 # DevExpress Reports for Delphi/C++Builder – Store Report Layouts in a Database
 
 This example application stores [DevExpress report layouts][TdxReport.Layout] in a database.
-The application allows users to create and save report layouts, modify existing layouts, and open layouts in Report Designer/Viewer.
+The application allows users to create new layouts, modify existing layouts using the built-in Report Designer,
+and save layout customizations to the data source.
 
 
 ## Prerequisites
@@ -20,23 +21,18 @@ The application allows users to create and save report layouts, modify existing
 
 ## Test the Example
 
-1.  Run the sample app and click **New Report** to create an empty database record.
+1.  Run the sample app and click **New Report**.
 1.  Click **Design Report** to display the [Report Designer][dx-report-designer] dialog.
     1.  Create a report layout using tools available within the UI.
     2.  Click the hamburger button, select the **Save** option, and close the dialog.
-2.  Close the app. The [TdxMemData] component will store layout data in the [data.dat] file between sessions.
-3.  Run the sample app again. Click **Design Report** to load the saved report layout,
-    or **Preview Report** to preview a layout-based report in the [Report Viewer][dx-report-viewer] dialog.
+2.  Close and restart the app.
+    Click **Design Report** or **Preview Report** to load the saved report in the designer or [Report Viewer][dx-report-viewer].
 
 ## Implementation Details
 
-Follow the instructions listed in this example to store report layouts in a desired database
-using the corresponding [TDataSet] descendant.
-
-The example uses a memory-based dataset
-([TdxMemData] inherited from the [TDataSet] class shipped with the standard VCL library).
-Applications in this example encapsulate data components within separate data modules:
-[uData.pas] (Delphi) and [uData.cpp] (C++Builder).
+The example uses a DevExpress memory-based dataset as a report layout storage: [TdxMemData].
+You can modify the application to use any [TDataSet] descendant instead.
+To review the data module implementation, see the following file: [uData.pas]/[uData.cpp].
 
 The instructions assume that you start with a Delphi or C++Builder project that already includes
 a configured data source for DevExpress Reports.
@@ -46,11 +42,10 @@ This example project uses a SQLite sample database ([nwind.db]) as a report data
 
 ### Step 1: Create a Dataset to Store Report Layout Data
 
-Follow these steps to create a memory-based dataset intended to store report layout data:
 
-1.  Create a [TdxMemData] component on a form (`mdLayouts` in the example).
-2.  Create a [TDataSource] component on a form (`dsLayouts` in the example). 
-    Assign the `TDataSource.DataSet` value to the previously created dataset component:
+1.  Add a [TdxMemData] component to the data module (`mdLayouts` in the example).
+2.  Add a [TDataSource] component to the data module (`dsLayouts` in the example). 
+    Assign the previously created dataset component to `TDataSource.DataSet`:
 
     > <img src="./images/create-bind-data-source.png" style="width: 50%" alt=""/>
 
@@ -68,9 +63,9 @@ Follow these steps to create a memory-based dataset intended to store report lay
 
 6.  (*Optional*) Preload persistent data to the dataset to make layouts available in the application upon first launch.
 
-    This example includes a sample report layout designed to use data from the Northwind sample database.
+    This example includes a sample report layout that displays data from the Northwind sample database.
     You can preload it from [example.dat].
-    Open the context menu for the dataset component, select **Persistent Editor…**, click **Load…** and select the file.
+    Open the context menu for the dataset component, select **Persistent Editor…**, click **Load…**, and select the file.
 
     > <img src="./images/create-persistent-data.png" style="width: 50%" alt=""/>
 
@@ -109,8 +104,8 @@ The assigned report replaces the current layout definition.
 
 ### Step 3: Display Report Designer and Viewer
 
-Once you have assigned name and layout to the [TdxReport] component,
-you can display the [Report Designer][dx-report-designer] and [Report Viewer][dx-report-viewer]:
+Once you assigned a name and layout to the [TdxReport] component,
+you can display [Report Designer][dx-report-designer] and [Report Viewer][dx-report-viewer] dialogs:
 
 ```pas
 procedure TMainForm.btnDesignClick(Sender: TObject);
@@ -131,7 +126,7 @@ end;
 
 When a user edits and saves a report in the Report Designer,
 the value of [TdxReport.Layout] changes and an [OnLayoutChanged] event is called.
-Handle this event to automatically store the updated layout in the active dataset record.
+Handle this event to save layout changes to the active dataset record.
 
 ```pas
 procedure TMainForm.dxReport1LayoutChanged(ASender: TdxReport);
@@ -149,12 +144,11 @@ end;
 ```
 
 
-### Step 5: Store the Database State Between Application Sessions
+### Step 5: Persist Data between Application Sessions
 
 This step is applicable only to the memory-based [TdxMemData] datasource.
 
-To store the database state when user closes the application
-and restore the state on app restart,
+To save the dataset to a file and restore data on app restart,
 handle `OnCreate` and `OnDestroy` events of the data module:
 
 ```pas
@@ -177,8 +171,8 @@ end;
 
 ## Files to Review
 
--   [uData.pas] (Delphi) and [uData.cpp] (C++Builder) store/restore layout data to/from a memory-based dataset component ([TdxMemData]).
--   [uMainForm.pas] (Delphi) and [uMainForm.cpp] (C++Builder) supply layout data from the data module to [TdxReport] and display Report Designer and Viewer.
+-   [uData.pas]/[uData.cpp] stores report layouts.
+-   [uMainForm.pas]/[uMainForm.cpp] creates a [TdxReport], loads report layouts from the data module, and displays Report Designer/Viewer.
 -   [data.dat] stores the memory-based dataset state between application sessions.
 -   [nwind.db] contains the Northwind sample database used as a data source for report content.
 
@@ -191,10 +185,10 @@ end;
 -   [Store report layouts in REPX files at design-time][reports-design-time-store]
 -   API reference:
     -   [TdxReport.ReportName] (internal report name that is not included in the layout)
-    -   [TdxReport.Layout] (an XML-based layout template that can be stored in the BLOB field of a database)
-    -   [TdxMemData] (used to store report layout data in application runtime and between sessions)
-    -   [TDataSet] (ancestor of the [TdxMemData], contains generic database connection methods)
-    -   [TdxBackendDatabaseSQLConnection] (used to supply data to reports)
+    -   [TdxReport.Layout] (an XML-based layout template that can be stored in a BLOB data field)
+    -   [TdxMemData] (a DevExpress in-memory dataset implementation)
+    -   [TDataSet] (contains generic database connection methods)
+    -   [TdxBackendDatabaseSQLConnection] (supplies data to reports)
 
 <!-- documentation links -->
 [reports-intro]: https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports