Apply suggestions from code review

Co-authored-by: Albert Totten <49917542+albertov05@users.noreply.github.com>
Co-authored-by: Vladimir Abadzhev <vladimira@devexpress.com>

Author: 3 people

README.md

@@ -9,18 +9,19 @@
 
 This example localizes DevExpress VCL Reports components in Delphi and C++ Builder projects.
 
-The [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports)
-fully supports UI localization. Projects in this repository give users a choice between English (default) and German (localized) versions of two built-in dialogs: [Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer) and
+The [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports) fully supports UI localization.
+The localization example in this repository gives users a choice between English (default) and German (localized) versions of two built-in dialogs:
+[Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer) and
 [Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer).
-The repository has example projects in [Delphi](./Delphi) and [C++ Builder](./CPB).
+The example includes projects for both [Delphi](./Delphi) and [C++ Builder](./CPB).
 
 **To localize the DevExpress Report Designer and Report Viewer interface** in your Delphi or C++ Builder project, refer to the following guide:
 [Report Viewer and Designer UI Localization](https://docs.devexpress.com/VCL/405598/ExpressReports/localization/vcl-report-viewer-and-designer-localization).
 
 **To localize the report contents**, refer to the following guide:
 [Report Localization](https://docs.devexpress.com/VCL/405599/ExpressReports/localization/vcl-report-localization).
 
-![Starting screen of the localization example, offering to select between English and German, and to display Report Designer and Report Viewer dialogs](./images/Lokalisierungsbeispiel.png)
+![Start screen of the localization example, offering to select between English and German, and to display Report Designer and Report Viewer dialogs](./images/Lokalisierungsbeispiel.png)
 
 ## Prerequisites
 
@@ -45,16 +46,16 @@ Learn more about the localization files required for each component from the fol
 [Localize Core Reporting Components: Use JSON Files](https://docs.devexpress.com/XtraReports/400932/web-reporting/common-features/localization/localization-in-asp-net-core-reporting-applications#use-json-files).
 
 To download localization files for various locales, you can use the [DevExpress Localization Service](https://localization.devexpress.com/).
-Learn more from the following guide: [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service).
+For additional information, see the following help topic: [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service).
 
 > **Note:** The localization mechanism demonstrated in this example applies only to DevExpress Report Designer and Report Viewer components.
 > The DevExpress VCL library components support localization using [resource files and the Localizer Editor](https://docs.devexpress.com/VCL/154039/ExpressCrossPlatformLibrary/how-to/localize-an-application).
 
 ## Files to Review
 
--   [`Delphi\uMainForm.pas`](./Delphi/uMainForm.pas) loads an example report from the file `ExampleReport.repx`.
+-   [`Delphi\uMainForm.pas`](./Delphi/uMainForm.pas) loads an example report from `ExampleReport.repx`.
     Event handlers assigned to `TcxRadioButton` components switch localization language between English and German.
--   Files in the [`Localization`](./Localization/) contain localized UI strings. 
+-   Files in the [`Localization`](./Localization/) folder contain localized UI strings.
 
 ## Documentation
 
@@ -68,11 +69,11 @@ Learn more from the following guide: [DevExpress UI Localization Service](https:
 
 Localized Report Designer:
 
-![VCL Report Designer dialog with interface localized in German language](./images/Berichtsdesigner.png)
+![VCL Report Designer dialog with interface localized into German](./images/Berichtsdesigner.png)
 
 Localized Report Viewer:
 
-![VCL Report Viewer dialog with interface localized in German language](./images/Berichtsanzeige.png)
+![VCL Report Viewer dialog with interface localized into German](./images/Berichtsanzeige.png)
 
 <!-- feedback -->
 ## Does this example address your development requirements/objectives?

README2.md

@@ -7,14 +7,15 @@
 
 # DevExpress VCL Reports - Localize the Report Viewer and Report Designer
 
-This example localizes DevExpress VCL Reports components in Delphi and C++ Builder projects.
+This example localizes DevExpress VCL Reports components. Delphi and C++ Builder projects are included.
 
 The [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports) fully supports UI localization.
-Projects in this repository give users a choice between English (default) and German (localized) versions of two built-in dialogs: [Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer) and
+The localization example in this repository gives users a choice between English (default) and German (localized) versions of two built-in dialogs:
+[Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer) and
 [Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer).
-The repository has example projects in [Delphi](./Delphi) and [C++ Builder](./CPB).
+The example includes projects for both [Delphi](./Delphi) and [C++ Builder](./CPB).
 
-![Starting screen of the localization example, offering to select between English and German, and to display Report Designer and Report Viewer dialogs](./images/Lokalisierungsbeispiel.png)
+![Start screen of the localization example, offering to select between English and German, and to display Report Designer and Report Viewer dialogs](./images/Lokalisierungsbeispiel.png)
 
 ## Prerequisites
 
@@ -26,37 +27,40 @@ The repository has example projects in [Delphi](./Delphi) and [C++ Builder](./CP
 ## Implementation Details
 
 To localize the DevExpress Report Designer and Report Viewer in your Delphi or C++ Builder application,
-use the following steps:
-
-1.  Determine the localization files you need, consulting the guide [Localize Core Reporting Components: Use JSON Files](https://docs.devexpress.com/XtraReports/400932/web-reporting/common-features/localization/localization-in-asp-net-core-reporting-applications#use-json-files).
-2.  Sign up for the [DevExpress Localization Service](https://localization.devexpress.com/) and request to download localization files.
-    To learn more, [refer to the corresponding guide](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service).
-3.  Create a `Localization` folder in the same folder as your compiled application executable.
-    Projects in this repository use `..` as the output path, so that both projects can use the same `Localization` folder.
-    Extract the downloaded localization files to the `Localization` folder.
-4.  To switch the Report Designer and Report Viewer interface to a specific language,
-    assign the language code to the [`Language`](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language) property of a [`TdxReport`](https://docs.devexpress.com/VCL/dxReport.TdxReport) component:
+do the following:
+
+1.  Use the [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service)
+    to obtain localization files for DevExpress VCL Report Viewer and Designer.
+    These files contain UI string translations for a specific language/locale.
+    Refer to the following guide for step-by-step instructions:
+    [Localize Core Reporting Components: Use JSON Files](https://docs.devexpress.com/XtraReports/400932/web-reporting/common-features/localization/localization-in-asp-net-core-reporting-applications#use-json-files).
+1.  Extract downloaded files to a `Localization` folder next to your compiled application executable.
+    Note that projects in this repository output their executables to the same location.
+    This allows both projects to use the same localization files.
+1. Assign a language code to the
+   [`TdxReport.Language`](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language)
+   property to switch the Report Designer and Report Viewer interface to a specific language.
 
     ```delphi
     dxReport1: TdxReport;
     // Switch to German Localization 
     dxReport1.Language := 'de-DE'
     ```
 
-For a more detailed step-by-step guide to localizing your applications, refer to the documentation:
+For a more detailed step-by-step guide to localizing your applications, refer to the following help topic:
 [Report Viewer and Designer UI Localization](https://docs.devexpress.com/VCL/405598/ExpressReports/localization/vcl-report-viewer-and-designer-localization).
 
-Localizing the contents of specific reports is out of scope for this example.
-Refer to the following guide to learn more: [Report Localization](https://docs.devexpress.com/VCL/405599/ExpressReports/localization/vcl-report-localization).
+This example doesn't localize report content.
+To localize report content in your project, refer to the following guide: [Report Localization](https://docs.devexpress.com/VCL/405599/ExpressReports/localization/vcl-report-localization).
 
 > **Note:** The localization mechanism demonstrated in this example applies only to DevExpress Report Designer and Report Viewer components.
 > The DevExpress VCL library components support localization using [resource files and the Localizer Editor](https://docs.devexpress.com/VCL/154039/ExpressCrossPlatformLibrary/how-to/localize-an-application).
 
 ## Files to Review
 
--   [`Delphi\uMainForm.pas`](./Delphi/uMainForm.pas) loads an example report from the file `ExampleReport.repx`.
+-   [`Delphi\uMainForm.pas`](./Delphi/uMainForm.pas) loads an example report from `ExampleReport.repx`.
     Event handlers assigned to `TcxRadioButton` components switch localization language between English and German.
--   Files in the [`Localization`](./Localization/) contain localized UI strings. 
+-   Files in the [`Localization`](./Localization/) folder contain localized UI strings.
 
 ## Documentation
 
@@ -70,11 +74,11 @@ Refer to the following guide to learn more: [Report Localization](https://docs.d
 
 Localized Report Designer:
 
-![VCL Report Designer dialog with interface localized in German language](./images/Berichtsdesigner.png)
+![VCL Report Designer dialog with interface localized into German](./images/Berichtsdesigner.png)
 
 Localized Report Viewer:
 
-![VCL Report Viewer dialog with interface localized in German language](./images/Berichtsanzeige.png)
+![VCL Report Viewer dialog with interface localized into German](./images/Berichtsanzeige.png)
 
 <!-- feedback -->
 ## Does this example address your development requirements/objectives?