update

Author: oblomov-dev

docs/advanced/technical/concept.md

@@ -1,6 +1,10 @@
 # Key Concept: UI5 Over-the-Wire?
 
-The key concept of **abap2UI5** is to apply the **HTML Over-the-Wire** concept to SAP UI5 application development.
+The key concept of **abap2UI5** is to apply the **HTML Over-the-Wire** approach to SAP UI5 application development.
+
+### HTML over-the-wire
+
+#### Concept
 
 **HTML Over-the-Wire** refers to a web architecture where the server renders user interfaces and sends ready-to-use HTML fragments to the browser. This avoids complex client-side frameworks and keeps the frontend lightweight and maintainable. The UI and Business Logic stays on the server.
 
@@ -35,15 +39,15 @@ As a reaction, the **Over-the-Wire** paradigm re-emerged:
 - Browsers update only specific parts of the page
 - Frontends stay simple and declarative
 
-#### Architectural Comparison
+###### Architectural Comparison
 
 | Approach | Data Flow | Rendering Location | Period |
 |----------|-----------|-------------------|--------|
 | **SSR** | Full-page HTML responses | Entirely on the server | 1990s – 2010s |
 | **SPA** | Raw data (JSON), client builds UI | Client-side (JavaScript) | 2010s – today |
 | **Over-the-Wire** | HTML fragments for partial updates | Server renders, browser inserts | 2020s (re-emerging) |
 
-#### Related Frameworks
+###### Related Frameworks
 
 Several frameworks successfully implement the HTML over-the-wire approach:
 
@@ -56,7 +60,7 @@ Several frameworks successfully implement the HTML over-the-wire approach:
 | [Unpoly](https://unpoly.com)            | Simplified partial page updates            | Any web stack        |
 
 
-#### UI5 Over-the-Wire
+### UI5 Over-the-Wire
 
 So how can a UI5 over-the-wire approach look like? In this architecture, the UI is defined on the ABAP server and transmitted to the browser. The browser renders the interface using a static UI5 application — without requiring additional JavaScript logic, OData services, or frontend frameworks.
 
@@ -80,7 +84,7 @@ Flow:
 - Backend-controlled UI & Business logic
 - Targeted ViewModel updates ensure that only specific UI5 controls are re-rendered
 
-#### Key Benefits
+###### Key Benefits
 
 - Static UI5 Frontend App: Delivered with the first HTTP request and remains generic and stable across all applications.
 - Backend-Driven UI Control: All UI definitions and business logic are implemented in ABAP classes.
@@ -89,13 +93,13 @@ Flow:
 - Seamless SAP Integration: Fully aligned with SAP’s UI5 and ABAP technology stack, compatible with all ERP and S/4HANA releases.
 - Efficient for Business Applications: Particularly well-suited for CRUD-heavy apps, forms, tables, dashboards, and typical enterprise use cases.
 
-#### Limitations to Consider
+###### Limitations
 
 - Not suitable for highly interactive, real-time collaboration apps.
 - Offline functionality or complex client-side interactions are not covered.
 - Less effective if frontend and backend teams work independently.
 
-#### Partly HTML Updates
+###### Partly HTML Updates
 One key feature is that the browser does not re-render the entire HTML page, but only specific parts. Can we achieve this with UI5?
 While modifying the XML view would typically trigger a complete re-render, focusing solely on updating the view model and binding UI attributes to it allows the UI5 framework to automatically update only the affected parts. Try out this snippet:
 
@@ -130,15 +134,15 @@ ENDCLASS.
 ```
 Isn't that beatuiful?
 
-#### Summary
+### Summary
 
 The **key concept of abap2UI5** is to bring the simplicity and efficiency of the HTML Over-the-Wire pattern into the SAP ecosystem.
 
 By shifting UI control back to the ABAP backend and leveraging SAP UI5 for rendering, abap2UI5 enables maintainable, pragmatic business applications — without the overhead of SPA architectures.
 
 For typical enterprise apps — forms, dashboards, transactions — abap2UI5 offers a clean, backend-driven alternative with faster time-to-market and lower complexity.
 
-#### Further Reading
+Further Reading:
 - [htmx in a nutshell](https://htmx.org/docs/#introduction)
 - [HTML Over the Wire](https://signalvnoise.com/svn3/html-over-the-wire/)
 - [Fiori-like web app development in pure ABAP with htmx and Fundamental](https://community.sap.com/t5/technology-blog-posts-by-members/fiori-like-web-app-development-in-pure-abap-with-htmx-and-fundamental/ba-p/13500763)