Revise introduction and about sections in documentation

oblomov-dev · web-flow · commit 00bec6cdbf33 · 2025-11-23T19:44:02.000-03:00
Updated the introduction and about sections for clarity and conciseness. Improved formatting and removed redundant information.
diff --git a/docs/get_started/about.md b/docs/get_started/about.md
@@ -3,7 +3,7 @@ outline: [2, 6]
 ---
 # Introduction
 
-**Developing UI5 Apps Purely in ABAP – no JavaScript, OData, or RAP required.**
+**Developing UI5 Apps Purely in ABAP– no JavaScript, OData, or RAP required.**
 
 abap2UI5 is an open-source framework that brings back the simplicity of classic ABAP development to modern UI5 applications. Just as Selection Screens and ALVs could generate functional UIs with minimal code, abap2UI5 lets you create web applications with just a few lines of ABAP.
 
@@ -15,107 +15,99 @@ ENDCLASS.
 
 CLASS my_app IMPLEMENTATION.
   METHOD z2ui5_if_app~main.
-    client->message_box( |Hello World|) ).
+    client->view_display( client->_z2ui5( )->page( 
+      title = 'Hello World'
+      content = client->_z2ui5( )->button( text = 'Click Me' ) ) ).
   ENDMETHOD.
 ENDCLASS.
 ```
 
 That's it – your first UI5 app is ready!
 
 ##### About
-abap2UI5 simplifies UI5 development for both cloud and on-premise environments, bringing back the simplicity of classic ABAP development. Just as Selection Screens and ALVs could generate functional UIs with minimal code, abap2UI5 lets you create modern web applications with just a few lines of ABAP. The framework handles all frontend complexity, allowing you to focus on business logic.
+Since launching in 2023, abap2UI5 has evolved from a personal project into a community-driven framework trusted by ABAP developers worldwide. The framework handles all frontend complexity, allowing you to focus purely on business logic while leveraging your existing ABAP skills.
 
-Since launching in 2023, abap2UI5 has evolved from a personal project into a community-driven framework trusted by ABAP developers worldwide, with active contributions, regular updates, and continuous improvements.
+→ *See our [Getting Started Guide](/get_started/quickstart) for step-by-step instructions*  
+→ *Browse [Sample Applications](/get_started/samples) to see abap2UI5 in action*
 
-##### Why abap2UI5?
-Traditional UI5 development requires JavaScript expertise, frontend deployment pipelines, and OData service configuration. abap2UI5 eliminates these complexities, letting ABAP developers leverage their existing skills to build modern UIs quickly. Whether you're modernizing legacy applications, building new business apps, or creating prototypes, abap2UI5 streamlines the development process without requiring additional frontend resources.
+### Why abap2UI5?
 
-##### Development
-Creating UI5 applications with abap2UI5 is straightforward:
-1. Define a new ABAP class
-2. Implement a method from the abap2UI5 interface
-3. Your app is ready!
+Traditional UI5 development requires JavaScript expertise, frontend deployment pipelines, and OData service configuration. abap2UI5 eliminates these complexities, making it ideal for:
 
-Each application is supported as an abapGit project, simplifying installation across systems without the need for extra deployment of frontend artifacts.
+- **Modernizing legacy applications** without rewriting business logic
+- **Rapid prototyping** of new business applications
+- **Developer productivity** when frontend resources are limited
+- **Proof of concepts** that can evolve into production apps
 
-→ *See our [Getting Started Guide](/get_started/quickstart) for step-by-step instructions*  
-→ *Browse [Sample Applications](/get_started/samples) to see abap2UI5 in action*
+Each application is packaged as an abapGit project, simplifying installation across systems without separate frontend deployments.
 
 ### Key Benefits
-<br>
 
 ##### Architecture
-abap2UI5 employs a "thin frontend" approach, with all processing, logic, and data management handled in the backend. This design simplifies configuration, minimizes client-side actions (such as clearing caches), and ensures that business logic and sensitive data remain securely on the server.
+abap2UI5 employs a "thin frontend" approach – all processing, logic, and data management stays in the backend. This design simplifies configuration, minimizes client-side complexity (no cache clearing hassles), and ensures business logic and sensitive data remain securely on the server.
 
 ##### Performance
-abap2UI5 is impressively fast! The frontend focuses exclusively on UI rendering via the UI5 framework, while the ABAP backend handles all processing with its full power. Unlike traditional UI5 applications that require separate OData calls for each view, abap2UI5 delivers XML views with data already embedded — significantly reducing network round trips and accelerating response times.
-
-##### System Footprint
-The abap2UI5 system footprint is kept as small as possible, including only essential classes and interfaces in the base version. Additional functionality can be added by installing optional addons.
+The frontend focuses exclusively on UI rendering via the UI5 framework, while the ABAP backend handles all processing. Unlike traditional UI5 applications requiring separate OData calls for each view, abap2UI5 delivers XML views with data already embedded – significantly reducing network round trips and accelerating response times.
 
 ##### Security
-abap2UI5 is exceptionally secure! All business logic remains exclusively in the ABAP backend, while the frontend receives only data populated directly in XML views. Unlike traditional UI5 applications that expose OData endpoints to clients, abap2UI5 delivers only the specific data users need — eliminating access to raw services or database queries through external tools.
- 
+All business logic remains exclusively in the ABAP backend. The frontend receives only data populated directly in XML views. Unlike traditional UI5 applications that expose OData endpoints, abap2UI5 delivers only the specific data users need – eliminating access to raw services or database queries through external tools.
+
+##### Minimal System Footprint
+The base framework includes only essential classes and interfaces. Additional functionality can be added through optional addons, keeping your system lean.
+
 ##### Transparency
-All source code is publicly available on GitHub. We discuss features and issues openly, publish technical blog posts explaining key concepts, and rapidly deploy fixes through abapGit. This commitment to transparency ensures you always understand how the framework works and can verify its behavior.
+All source code is publicly available on GitHub. We discuss features and issues openly, publish technical blog posts explaining key concepts, and rapidly deploy fixes through abapGit. You always understand how the framework works and can verify its behavior.
 
 ### Compatibility
-<br>
 
 ##### ABAP Cloud
-abap2UI5 uses only released APIs, making it suitable for both on-stack and side-by-side extensions in ABAP for Cloud. You can use modern ABAP syntax features like CDS, ABAP SQL, and EML within your apps.
+abap2UI5 uses only released APIs, making it suitable for both on-stack and side-by-side extensions in ABAP for Cloud. Use modern ABAP syntax features like CDS, ABAP SQL, and EML within your apps.
 
 ##### Clean Core
-By relying only on released APIs, abap2UI5 ensures that your applications remain "cloud-ready" and "upgrade-stable," aligning with SAP's clean core principles. Your investment in abap2UI5 apps is protected against future SAP system upgrades.
-
-##### ABAP Classic
-The framework does not rely on newer ABAP syntax features, ensuring compatibility with on-premise and R/3 NetWeaver systems. A downported version is available for systems running ABAP versions earlier than 7.50.
+By relying only on released APIs, abap2UI5 ensures your applications remain "cloud-ready" and "upgrade-stable," aligning with SAP's clean core principles. Your investment in abap2UI5 apps is protected against future SAP system upgrades.
 
 ##### System Support
-abap2UI5 is compatible with both ABAP Cloud and Standard ABAP, supporting all ABAP releases from version 7.02 to ABAP Cloud:
+Compatible with both ABAP Cloud and Standard ABAP, supporting all ABAP releases from version 7.02 to ABAP Cloud:
 * S/4 Public Cloud and BTP ABAP Environment (ABAP for Cloud)
 * S/4 Private Cloud or On-Premise (ABAP for Cloud, Standard ABAP)
 * R/3 NetWeaver AS ABAP 7.02 or higher (Standard ABAP)
 
-### Operations
-<br>
-
-##### Installation
-Installing abap2UI5 is easy:
-1. Import the project via abapGit
-2. Create a new HTTP service to establish browser communication
-3. Start developing!
-
-No additional deployment or configuration steps are needed.
+A downported version is available for systems running ABAP versions earlier than 7.50.
 
-→ *See our [Installation Guide](/get_started/quickstart) for detailed instructions*
+### Enterprise Ready
 
-##### Enterprise Ready
-This framework is tailored for enterprise SAP environments, combining SAP's UI5 framework with ABAP's robust backend capabilities. abap2UI5 provides an enterprise-ready way to create software compatible with a wide range of SAP products, from S/4HANA Public/Private Cloud to BTP ABAP Environment and NetWeaver systems.
+abap2UI5 combines SAP's UI5 framework with ABAP's robust backend capabilities, tailored for enterprise SAP environments. The framework works seamlessly across S/4HANA Public/Private Cloud, BTP ABAP Environment, and NetWeaver systems.
 
-##### Productive Usage
-abap2UI5 can be used like any other UI5 app or ABAP program in a productive environment. Simply add the framework and your apps to a transport request to deploy them to your productive system.
+##### Production Usage
+Use abap2UI5 like any other UI5 app or ABAP program in production. Simply add the framework and your apps to a transport request for deployment.
 
 ##### Launchpad Integration
-Apps developed with abap2UI5 can be integrated into:
+Integrate your apps into:
 * Fiori Launchpads on S/4 On-Premise
 * Tiles on S/4 Public Cloud
 * Build Workzone Websites on BTP
 
+##### Installation
+Getting started is straightforward:
+1. Import the project via abapGit
+2. Create an HTTP service for browser communication
+3. Start developing!
+
+→ *See our [Installation Guide](/get_started/quickstart) for detailed instructions*
+
 ### Community
-<br>
 
 ##### Support
-Support is provided by the community. Need help? Submit an issue on GitHub or join the abap2UI5 Slack channel for assistance.
+Support is provided by the community. Submit an issue on GitHub or join the abap2UI5 Slack channel for assistance.
 
 → *Visit our [Support page](/resources/support) for more options*
 
 ##### Contribution
-Contributions are always welcome! Whether you're fixing bugs, creating new features, or improving documentation, your input helps the project grow. Check out our contribution guidelines to get started.
+Contributions are always welcome! Whether you're fixing bugs, creating new features, or improving documentation, your input helps the project grow.
 
 → *Read our [Contribution Guide](/resources/contribution) to learn how to get involved*
 
 ##### Sponsor
-abap2UI5 is maintained by volunteers. If you or your company benefit from the project but cannot contribute directly, consider supporting the project in other ways.
+abap2UI5 is maintained by volunteers. If you or your company benefit from the project, consider supporting it.
 
 → *Learn more about [sponsorship opportunities](/resources/sponsor)*
