readme: Add example and reference links

- Refactor the links structure to simplify maintenance.
- Bring the file and code entity links to the DevExpress standard.
- Add meta-markup to the code snippet blocks.
  Experimental markup to improve example import to the DevExpress Support Center.

Author: NickVolynkin

README.md

@@ -5,9 +5,9 @@
 [![](https://img.shields.io/badge/💬_Leave_Feedback-feecdd?style=flat-square)](#does-this-example-address-your-development-requirementsobjectives)
 <!-- default badges end -->
 
-# DevExpress&nbsp;VCL&nbsp;Reports&nbsp;– Import&nbsp;and&nbsp;Save Report&nbsp;Layouts to XML&nbsp;Files
+# DevExpress Reports for Delphi/C++Builder – Import and Save Report Layouts to XML Files
 
-This example uses XML-based REPX files as [report layout](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports) storage.
+This example uses XML-based REPX files as [report layout][vcl-reports] storage.
 
 Run the app and execute the following actions:
 
@@ -20,19 +20,20 @@ Run the app and execute the following actions:
 
 ## Prerequisites
 
-[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
 
 ### Import a Report Layout from a File
 
-To import (load) a report layout from a file, call the 
-[`Layout.LoadFromFile`](https://docwiki.embarcadero.com/Libraries/Athens/en/System.Classes.TStrings.LoadFromFile)
-method and assign a name to the
-[`ReportName`](https://docs.devexpress.com/VCL/dxReport.TdxReport.ReportName) property: 
+To import (load) a report layout from a file, call the [Layout.LoadFromFile]
+method and assign a name to the [ReportName] property:
 
-**Delphi:**
+<!-- start-code-block -->
+#### Delphi
 ```delphi
 procedure TMainForm.ImportReport(const AFileName: string);
 begin
@@ -43,7 +44,7 @@ begin
 end;
 ```
 
-**C++Builder:**
+#### C++Builder
 ```cpp
 void __fastcall TMainForm::ImportReport(const String &FileName)
 {
@@ -53,17 +54,18 @@ void __fastcall TMainForm::ImportReport(const String &FileName)
     dxReport1->ReportName = ChangeFileExt(ExtractFileName(FileName), "");
 }
 ```
+<!-- end-code-block -->
 
 > [!Note]
 > An internal report name may differ from the source REPX file name.
 
 
 ### Save a Report Layout to a File
 
-To save the current report layout to a file, call the 
-[`Layout.SaveToFile`](https://docwiki.embarcadero.com/Libraries/Athens/en/System.Classes.TStrings.SaveToFile) method:
+To save the current report layout to a file, call the [Layout.SaveToFile] method:
 
-**Delphi:**
+<!-- start-code-block -->
+#### Delphi
 ```delphi
 procedure TMainForm.SaveReport(const AFileName: string);
 begin
@@ -72,14 +74,15 @@ begin
 end;
 ```
 
-**C++Builder:**
+#### C++Builder
 ```cpp
 void __fastcall TMainForm::SaveReport(const String &FileName)
 {
     // Save the report layout to a file
     dxReport1->Layout->SaveToFile(FileName);
 }
 ```
+<!-- end-code-block -->
 
 > [!Note]
 > Internal report names are not stored in REPX files.
@@ -89,20 +92,20 @@ void __fastcall TMainForm::SaveReport(const String &FileName)
 
 ### Modify the Pre-loaded Layout and Save to a New File
 
-The example application loads a predefined layout at startup: `TableReport.repx`.
+The example application loads a predefined layout at startup: [TableReport.repx].
 You can modify this preloaded report layout and then save changes to a REPX file.
 
 1.  Build and run the sample application. 
     Note the preloaded layout's name in the application's caption.
 2.  Click **Open Designer** to edit the loaded layout in the DevExpress
-    [Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer).
+    [Report Designer][designer].
     Modify the layout as you see fit.
 3.  Once you have made changes in the **Report Designer** dialog, click the hamburger button, select **Save**, and close the dialog.
 4.  Click **Save to File** to save the report layout to a REPX file.
     You can overwrite an existing file or create a new file.
 5.  Restart the application and click **Import from File** to import a report layout from the previously saved REPX file.
 6.  Click **Open Viewer** to display the imported layout in the DevExpress
-    [Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer).
+    [Report Viewer][viewer].
 
 
 ### Create, Design, and Save a New Layout
@@ -111,27 +114,54 @@ You can design a new layout from scratch and then save it to a REPX file:
 
 1.  Build and run the sample application.
 2.  Click **Create New** to open a new blank report layout in the DevExpress
-    [Report Designer](https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer).
+    [Report Designer][designer].
 3.  Design the report layout (template) using tools available in the **Report Designer**.  
-    Follow the tutorial: [Create a table report using the Report Wizard](https://docs.devexpress.com/VCL/405760/ExpressReports/getting-started/create-table-report-using-report-wizard).
+    Follow the tutorial: [Create a table report using the Report Wizard][wizard-tutorial].
 4.  Once you have made all necessary changes in the **Report Designer** dialog, click the hamburger button, select **Save**, and enter a report layout name.
     Click **Save** and close the dialog.
 5.  Click **Save to File** to save the report layout to a REPX file.
 6.  Restart the application and click **Import from File** to import a report layout from the previously saved REPX file.
 7.  Click **Open Viewer** to display the imported layout in the DevExpress
-    [Report Viewer](https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer).
+    [Report Viewer][viewer].
+
+
+## Files to Review
+
+-   [uMainForm.pas] (Delphi) and [uMainForm.cpp] (C++Builder) import and save report layouts to REPX files.
+-   [TableReport.repx] contains a report layout designed to generate a customer order report.
+
+[uMainForm.pas]: ./Delphi/uMainForm.pas
+[uMainForm.cpp]: ./CPB/uMainForm.cpp
+[TableReport.repx]: ./Table%20Report.repx
+
+## Documentation
+
+-   [Introduction to VCL Reports][vcl-reports]
+-   [Tutorial: Create a table report using the Report Wizard][wizard-tutorial]
+-   [Store report layouts in REPX files at design-time](https://docs.devexpress.com/VCL/dxReport.TdxReport.Layout#string-list-editor)
+-   [Use SQLite as a data source for reports (as demonstrated in the current example)](https://docs.devexpress.com/VCL/405750/ExpressCrossPlatformLibrary/vcl-backend/database-engines/vcl-backend-sqlite-support)
+-   API reference: 
+    -   [TdxReport.Layout]
+    -   [TdxReport.Layout.LoadFromFile][Layout.LoadFromFile]
+    -   [TdxReport.Layout.SaveToFile][Layout.SaveToFile]
+    -   [TdxReport.ReportName][ReportName]
+    -   [TdxBackendDatabaseSQLConnection]
 
+[vcl-reports]: https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports
+[designer]: https://docs.devexpress.com/XtraReports/119176/web-reporting/web-end-user-report-designer
+[viewer]: https://docs.devexpress.com/XtraReports/401850/web-reporting/web-document-viewer
+[wizard-tutorial]: https://docs.devexpress.com/VCL/405760/ExpressReports/getting-started/create-table-report-using-report-wizard
 
-## Documentation and Examples
+[TdxReport.Layout]: https://docs.devexpress.com/VCL/dxReport.TdxReport.Layout
+[Layout.LoadFromFile]: https://docwiki.embarcadero.com/Libraries/Athens/en/System.Classes.TStrings.LoadFromFile
+[Layout.SaveToFile]: https://docwiki.embarcadero.com/Libraries/Athens/en/System.Classes.TStrings.SaveToFile
+[ReportName]: https://docs.devexpress.com/VCL/dxReport.TdxReport.ReportName 
+[TdxBackendDatabaseSQLConnection]: https://docs.devexpress.com/VCL/dxBackend.ConnectionString.SQL.TdxBackendDatabaseSQLConnection
 
--   [Introduction to VCL Reports](https://docs.devexpress.com/VCL/405469/ExpressReports/vcl-reports)
--   [Tutorial: Create a table report using the Report Wizard](https://docs.devexpress.com/VCL/405760/ExpressReports/getting-started/create-table-report-using-report-wizard)
--   [How to store report layouts in REPX files at design-time](https://docs.devexpress.com/VCL/dxReport.TdxReport.Layout#string-list-editor)
--   [How to store report layouts in a database (example application)](https://github.com/DevExpress-Examples/vcl-reports-store-layout-template-database)
--   [How to use SQLite as a data source for reports (as demonstrated in the current example)](https://docs.devexpress.com/VCL/405750/ExpressCrossPlatformLibrary/vcl-backend/database-engines/vcl-backend-sqlite-support)
--   [API reference: `TdxReport.Layout` Property](https://docs.devexpress.com/VCL/dxReport.TdxReport.Layout)
--   [API reference: `TdxBackendDatabaseSQLConnection` Component](https://docs.devexpress.com/VCL/dxBackend.ConnectionString.SQL.TdxBackendDatabaseSQLConnection)
+## More Examples
 
+-   [Store DevExpress VCL Report Layouts in a Database](https://github.com/DevExpress-Examples/vcl-reports-store-layout-template-database)
+-   [Localize the DevExpress VCL Report Viewer and Report Designer UI](https://github.com/DevExpress-Examples/vcl-reports-localize)
 
 <!-- feedback -->
 ## Does This Example Address Your Development Requirements/Objectives?