readme: Explain example purpose and restructure

- Explain the localization mechanism in more detail.
- Add screenshots of localized Report Designer and Report viewer.
- Add links to documentation
- Give an overview of files with relevant code

Signed-off-by: Nick Volynkin <nikolay.volynkin@devexpress.com>

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

Author: 4 people

README.md

@@ -1,21 +1,88 @@
 <!-- default badges list -->
 ![](https://img.shields.io/endpoint?url=https://codecentral.devexpress.com/api/v1/VersionRange/1048527919/25.2.3%2B)
 [![](https://img.shields.io/badge/Open_in_DevExpress_Support_Center-FF7200?style=flat-square&logo=DevExpress&logoColor=white)](https://supportcenter.devexpress.com/ticket/details/T1305951)
-[![](https://img.shields.io/badge/📖_How_to_use_DevExpress_Examples-e9f6fc?style=flat-square)](https://docs.devexpress.com/GeneralInformation/403183)
+[![](https://img.shields.io/badge/📖_How_to_use_DevExpress_Examples-e9f6fc?style=flat-square)](https://docs.devexpress.com/GeneralInformation/403183/help-resources/devexpress-code-examples)
 [![](https://img.shields.io/badge/💬_Leave_Feedback-feecdd?style=flat-square)](#does-this-example-address-your-development-requirementsobjectives)
 <!-- default badges end -->
-# DevExpress VCL Reports - Localize the DevExpress Report Viewer and Report Designer
 
-This example localizes DevExpress VCL [Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer)/[Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer) dialogs ([TdxReport](https://docs.devexpress.com/VCL/dxReport.TdxReport) component). German UI localization strings are stored within the project's [Localization](https://github.com/DevExpress-Examples/vcl-reports-localize/tree/25.1.4%2B/Localization) folder as JSON files. You can download UI localizations for additional languages from the [DevExpress Localization Service](https://localization.devexpress.com/).
+# DevExpress VCL Reports—Localize the Report Viewer and Report Designer
 
-<img width="1049" height="697" alt="vcl-reports-tdxreport-report-viewer-localization" src="https://github.com/user-attachments/assets/8e2366ae-501e-4b53-a8d9-865ba7155a2c" />
+This example localizes DevExpress VCL Reports components.
+
+The [DevExpress Reporting Platform](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports) has full support for 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 example includes projects for both [Delphi](./Delphi) and [C++ Builder](./CPB).
+
+![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
+
+-   Microsoft Windows 10 or newer
+-   Embarcadero RAD Studio IDE 12.3 (Athens) or newer (Community Edition is not supported)
+-   The [EdgeView2 SDK](https://getitnow.embarcadero.com/edgeview2-sdk/) package installed from GetIt
+-   DevExpress VCL Components v25.2.3 or newer
+
+## Implementation Details
+
+To localize the DevExpress Report Designer and Report Viewer in your Delphi or C++ Builder application,
+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 identifier (also known as [locale][1] or [culture identifier][2]) to the
+   [`TdxReport.Language`](https://docs.devexpress.com/VCL/dxReport.TdxReport.Language)
+   property to switch the Report Designer and Report Viewer UI to a specific language:
+
+    ```delphi
+    dxReport1: TdxReport;
+    // 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 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).
+
+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).
+
+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 `ExampleReport.repx`.
+    Event handlers assigned to [`TcxRadioButton`](https://docs.devexpress.com/VCL/cxRadioGroup.TcxRadioButton)
+    components switch localization language between English and German.
+-   [`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)
+-   [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)
+
+## Localized Report Dialogs Preview
+
+Localized Report Designer:
+
+![VCL Report Designer dialog with interface localized into German](./images/Berichtsdesigner.png)
+
+Localized Report Viewer:
+
+![VCL Report Viewer dialog with interface localized into German](./images/Berichtsanzeige.png)
 
 <!-- feedback -->
 ## Does this example address your development requirements/objectives?