diff --git a/README.md b/README.md
index 43bcd8f..90b6da0 100644
--- a/README.md
+++ b/README.md
@@ -5,43 +5,44 @@
[](#does-this-example-address-your-development-requirementsobjectives)
-# DevExpress VCL Reports — Localize the DevExpress Report Viewer and Report Designer
+# DevExpress Reports for Delphi/C++Builder — Localize the Report Viewer and Report Designer
This example localizes DevExpress VCL Reports components.
-The [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports) fully supports UI localization.
-The localization example in this repository allows users to select between English (default) and German (localized) versions of two built-in DevExpress 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 [DevExpress Reports for Delphi/C++Builder][vcl-reports-intro] fully support UI localization.
+The localization example in this repository allows users to select between English (default) and German (localized) versions
+of two built-in DevExpress dialogs: [Report Designer][dx-report-designer] and [Report Viewer][dx-report-viewer].
The example includes projects for both [Delphi](./Delphi) and [C++Builder](./CPB).
-
## Prerequisites
-See the [DevExpress Reports Prerequisites](
-https://docs.devexpress.com/VCL/405773/ExpressCrossPlatformLibrary/vcl-backend/reports-dashboards-app-deployment#vcl-reportsdashboards-prerequisites).
+[DevExpress Reports Prerequisites][req]
+
+[req]: https://docs.devexpress.com/VCL/405773/ExpressCrossPlatformLibrary/vcl-backend/reports-dashboards-app-deployment#vcl-reportsdashboards-prerequisites
## Implementation Details
To localize the DevExpress Report Designer and Report Viewer in your Delphi or C++Builder application,
you must:
-1. Use the [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service)
+1. Use the [DevExpress UI Localization Service][localization-service]
to obtain localization files for DevExpress VCL Report Viewer and Designer.
These files contain UI string translations for specific languages/locales.
Refer to the following guide to learn more:
- [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.
+ [Localize Core Reporting Components: Use JSON Files][l10n-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 identifier (also known as [locale][1] or [culture identifier][2]) to the
- [`TdxReport.Language`](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language)
+1. Assign a language identifier (also known as [locale][locale] or [culture identifier][culture]) to the
+ [TdxReport.Language]
property to switch the Report Designer/Report Viewer to the desired language:
- **Delphi:**
+
+ #### Delphi
```delphi
dxReport1: TdxReport;
@@ -49,40 +50,77 @@ you must:
dxReport1.Language := 'de-DE'
```
- **C++Builder:**
- ```cpp
+ #### C++Builder
+ ```c
TdxReport *dxReport1;
// Switch Report UI to German
dxReport1->Language = "de-DE";
```
-
-[1]: https://learn.microsoft.com/en-us/globalization/reference/glossary#locale
-[2]: https://learn.microsoft.com/en-us/dotnet/fundamentals/runtime-libraries/system-globalization-cultureinfo#culture-names-and-identifiers
+
For a step-by-step guide, 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).
+[Report Viewer and Designer UI Localization][viewer-designer-l10n].
This example does not 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).
+To localize report content in your project, refer to the following guide: [Report Content Localization][report-content-l10n].
The localization mechanism described in this example applies only to the DevExpress Report Designer and Report Viewer.
-Other DevExpress VCL components support localization using [resource files and the Localizer Editor](https://docs.devexpress.com/VCL/154039/ExpressCrossPlatformLibrary/how-to/localize-an-application).
+Other DevExpress VCL components support localization using [resource files and the Localizer Editor][localize-an-application].
+
## Files to Review
-- [`Delphi/uMainForm.pas`](./Delphi/uMainForm.pas) loads an example report from `ExampleReport.repx`.
- Event handlers assigned to [`TcxRadioButton`](https://docs.devexpress.com/VCL/cxRadioGroup.TcxRadioButton)
+- [uMainForm.pas] (Delphi) and [uMainForm.cpp] (C++Builder) load an example report from [ExampleReport.repx].
+ Event handlers assigned to [TcxRadioButton]
components switch localization language between English and German.
-- [`Localization/*.de.json`](./Localization/) files contain localized UI strings.
+- [localization/*.de.json][localization] files contain localized UI strings.
## Documentation
-- [VCL Report Viewer and Designer UI Localization](https://docs.devexpress.com/VCL/405598/ExpressReports/localization/vcl-report-viewer-and-designer-localization)
-- [VCL Reports Localization](https://docs.devexpress.com/VCL/405597/ExpressReports/vcl-reports-localization)
-- [DevExpress UI Localization Service](https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service)
-- [TdxReport.Language Property](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language)
-- [ExpressReports Application Deployment Requirements](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports#expressreports-app-deployment)
+- [VCL Report Viewer and Designer UI Localization][viewer-designer-l10n]
+- [VCL Reports Localization][reports-l10n]
+- [DevExpress UI Localization Service][l10n-service]
+- [ExpressReports Application Deployment Requirements][req]
+- API reference:
+ - [TdxReport](https://docs.devexpress.com/VCL/dxReport.TdxReport)
+ - [TdxReport.Layout](https://docs.devexpress.com/VCL/dxReport.TdxReport.Layout)
+ - [TdxReport.Language]
+
+
+[vcl-reports-intro]: https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports
+[dx-report-viewer]: https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer
+[dx-report-designer]: https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer
+[reports-l10n]: https://docs.devexpress.com/VCL/405597/ExpressReports/vcl-reports-localization
+[report-content-l10n]: https://docs.devexpress.com/VCL/405599/ExpressReports/localization/vcl-report-localization
+[viewer-designer-l10n]: https://docs.devexpress.com/VCL/405598/ExpressReports/localization/vcl-report-viewer-and-designer-localization
+[l10n-service]: https://docs.devexpress.com/GeneralInformation/16235/localization/localization-service
+[l10n-json-files]: https://docs.devexpress.com/XtraReports/400932/web-reporting/common-features/localization/localization-in-asp-net-core-reporting-applications#use-json-files
+[localize-an-application]: https://docs.devexpress.com/VCL/154039/ExpressCrossPlatformLibrary/how-to/localize-an-application
+
+
+[TdxReport.Language]: https://docs.devexpress.com/VCL/dxReport.TdxReport.Language
+[TcxRadioButton]: https://docs.devexpress.com/VCL/cxRadioGroup.TcxRadioButton
+
+
+[locale]: https://learn.microsoft.com/en-us/globalization/reference/glossary#locale
+[culture]: https://learn.microsoft.com/en-us/dotnet/fundamentals/runtime-libraries/system-globalization-cultureinfo#culture-names-and-identifiers
+
+
+[localization]: ./localization/
+[uMainForm.pas]: ./Delphi/uMainForm.pas
+[uMainForm.cpp]: ./CPB/uMainForm.cpp
+[ExampleReport.repx]: ./ExampleReport.repx
+
+
+## More Examples
+
+- [Store Report Layouts in REPX Files][file-example]
+- [Store Report Layouts in a Database][database-example]
+
+[file-example]: https://github.com/DevExpress-Examples/vcl-reports-store-layout-template-file
+[database-example]: https://github.com/DevExpress-Examples/vcl-reports-store-layout-template-database
+
## Localized Report Dialogs Preview
diff --git a/Localization/dx-analytics-core.de.json b/localization/dx-analytics-core.de.json
similarity index 100%
rename from Localization/dx-analytics-core.de.json
rename to localization/dx-analytics-core.de.json
diff --git a/Localization/dx-dashboard.de.json b/localization/dx-dashboard.de.json
similarity index 100%
rename from Localization/dx-dashboard.de.json
rename to localization/dx-dashboard.de.json
diff --git a/Localization/dx-reporting.de.json b/localization/dx-reporting.de.json
similarity index 100%
rename from Localization/dx-reporting.de.json
rename to localization/dx-reporting.de.json
diff --git a/Localization/dx-rich.de.json b/localization/dx-rich.de.json
similarity index 100%
rename from Localization/dx-rich.de.json
rename to localization/dx-rich.de.json