Apply suggestions from code review

Co-authored-by: Dmitry Eliseev <81766219+dmitry-eliseev-devexpress@users.noreply.github.com>

Author: NickVolynkin

Delphi/uMainForm.pas

@@ -75,7 +75,7 @@ procedure TMainForm.SaveReportNameAndLayout();
   DataModule1.mdLayoutsName.AsString := dxReport1.ReportName;
   // Save the report layout
   DataModule1.mdLayoutsLayout.Assign(dxReport1.Layout);
-  // Finish editing and write a modified record
+  // Finish editing and post the modified record to the database
   DataModule1.mdLayouts.Post;
 end;
 

README.md

@@ -30,7 +30,7 @@ The application allows users to create and save report layouts, modify existing
 
 ## Implementation Details
 
-Follow the instructions in this example to store report layouts in a database of your choice,
+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
@@ -52,32 +52,32 @@ Follow these steps to create a memory-based dataset to store report layout data:
 
     > <img src="./images/create-bind-data-source.png" style="width: 50%" alt=""/>
 
-3.  Open the context menu of the dataset component and select **Field Editor…**:
+3.  Open the context menu for the dataset component and select **Field Editor…**:
 
     > <img src="./images/open-context-menu.png" style="width: 50%" alt=""/>
 
 4.  Click **Add…** to create a BLOB field for layout data:
 
     > <img src="./images/create-layout-field.png" style="width: 50%" alt=""/>
 
-5.  Click **Add…** to create a string field for layout name:
+5.  Click **Add…** to create a string field for layout names:
 
     > <img src="./images/create-name-field.png" style="width: 50%" alt=""/>
 
 6.  (*Optional*) Preload persistent data to the dataset make layouts available in the application upon first launch.
-    Open the context menu of the dataset component, select **Persistent Editor…**, click **Load…** and select a DAT file.
+    Open the context menu for the dataset component, select **Persistent Editor…**, click **Load…** and select the DAT file.
 
     > <img src="./images/create-persistent-data.png" style="width: 50%" alt=""/>
 
-    This example has an example report layout designed to use data from the Northwind sample database.
+    This example includes an sample report layout designed to use data from the Northwind sample database.
     You can preload it from [example.dat].
 
-    Alternatively, you can use the Report Designer in further steps to import report data from files or raw string data.
+    Alternatively, you can use the Report Designer later to import report data from a file.
 
 
-### Step 2: Supply Layout Data to TdxReport
+### Step 2: Load a Report Layout Definition
 
-Supply the [TdxReport] component with two values:
+To load a layout definition to the [TdxReport] component, you must specify
 report name ([TdxReport.ReportName]) and layout ([TdxReport.Layout]):
 
 ```pas
@@ -96,7 +96,7 @@ end;
 ```
 
 To load a different report, assign a new report name and layout.
-No cleanup is required between reports.
+The assigned report replaces the current layout definition.
 
 <!-- 
 1.  Assign report name and layout when application starts.
@@ -128,7 +128,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 store the updated layout in the active dataset record.
+Handle this event to automatically store the updated layout in the active dataset record.
 
 ```pas
 procedure TMainForm.dxReport1LayoutChanged(ASender: TdxReport);
@@ -139,18 +139,18 @@ begin
   DataModule1.mdLayoutsName.AsString := dxReport1.ReportName;
   // Save the report layout
   DataModule1.mdLayoutsLayout.Assign(dxReport1.Layout);
-  // Finish editing and write a modified record
+  // Finish editing and post the modified record to the database
   DataModule1.mdLayouts.Post;
 end;
 ```
 
-### Step 6: Persist the Database State Between Application Sessions
+### Step 6: Store the Database State Between Application Sessions
 
-This step is specific to the memory-based [TdxMemData] datasource.
+This step is applicable only to the memory-based [TdxMemData] datasource.
 
-To persist the database state when user closes the application
-and restore the state when user restarts the application,
-handle the `Create` and `Destroy` events of the data module:
+To store the database state when user closes the application
+and restore the state on app restart,
+handle `OnCreate` and `OnDestroy` events of the data module:
 
 ```pas
 const
@@ -172,9 +172,9 @@ end;
 
 ## Files to Review
 
--   [uData.pas] (Delphi) and [uData.cpp] (C++Builder) read and store layout data in a database represented by an in-memory storage component.
+-   [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.
--   [data.dat] persists the memory-based dataset between application sessions.
+-   [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.