update

Author: oblomov-dev

docs/.vitepress/config.mjs

@@ -107,7 +107,7 @@ export default defineConfig({
         link: '/configuration/configuration',
         collapsed: true,
         items: [      
-          { text: 'Settings', link: '/configuration/setup' },
+          { text: 'General', link: '/configuration/setup' },
           { text: 'Security', link: '/configuration/security' },
           { text: 'Authorization', link: '/configuration/authorization' },
           { text: 'Performance', link: '/configuration/performance' },
@@ -144,13 +144,16 @@ export default defineConfig({
           { text: 'Remote App Calls', link: '/addons/rfc' },
           { text: 'Extensibility', link: '/advanced/extensibility' },
           { text: 'Technical Background', link: '/advanced/insights/insights' , items: [
-          { text: 'General', link: '/advanced/insights/insights' },
-          { text: 'open-abap', link: '/advanced/insights/open_abap' },
+            { text: 'General', link: '/advanced/insights/insights' },
+            { text: 'open-abap', link: '/advanced/insights/open_abap' },
             // { text: 'CI/CD', link: '/insights/ci' },
             // { text: 'abaplint', link: '/insights/ci' },
           ]
-          } ]
+          },
+      
+         ]
       },
+      
       {
         text: 'Resources',
         link: '/resources/resources',

docs/configuration/setup.md

@@ -2,7 +2,7 @@
 outline: [2, 4]
 ---
 
-# Settings
+# General
 
 abap2UI5 can be run with various custom configurations. This is the call for the default setup:
 ```abap

docs/get_started/about.md

@@ -1,50 +1,50 @@
 ---
 outline: [2, 6]
 ---
-# Introduction
+# About
 
-Welcome to abap2UI5 – an open-source project for developing UI5 apps purely in ABAP.
+Welcome to **abap2UI5** – an open-source project designed to enable UI5 app development purely in ABAP.
 
 ##### Features
-abap2UI5 offers a pure ABAP approach to developing UI5 apps, without the need for JavaScript, OData, or RAP. Similar to classic ABAP, where a few lines of code were enough to display input forms and tables using Selection Screens & ALVs.
+abap2UI5 provides a purely ABAP-based approach for developing UI5 applications, with no need for JavaScript, OData, or RAP. It recalls the simplicity of classic ABAP, where just a few lines of code could generate input forms and tables using Selection Screens and ALVs.
 
 ##### Evolution
-Launched in 2023 as a personal project, abap2UI5 began with basic selection screen functionality for ABAP Cloud and an initial blog post on SCN. Thanks to contributions from the ABAP open-source community, the project has continuously evolved. Today, abap2UI5 boasts a wide range of features and is a thriving, community-driven initiative.
+Launched in 2023 as a personal project, abap2UI5 initially focused on offering basic selection screen functionality for ABAP Cloud, accompanied by an introductory blog post on the SAP Community Network (SCN). With the invaluable support of the ABAP open-source community, it has grown significantly, adding a broad range of features. Today, abap2UI5 is a thriving, community-driven initiative.
 
 ##### Compatibility
 ![alt text](image-15.png){ width=50% }
-abap2UI5 runs with both language versions `ABAP Cloud` and `Standard ABAP`. It is compatible with all ABAP releases, starting from ABAP v7.02 up to ABAP for Cloud, including systems R/3 NetWeaver, S/4 On-Premise, S/4 Private Cloud and in cloud environments BTP ABAP Environment and S/4 Public Cloud.
+abap2UI5 is compatible with both `ABAP Cloud` and `Standard ABAP`, supporting all ABAP releases from version 7.02 to ABAP for Cloud. It runs seamlessly on systems including R/3 NetWeaver, S/4HANA On-Premise, and S/4HANA Private Cloud, as well as cloud environments such as the BTP ABAP Environment and S/4HANA Public Cloud.
 
 ##### Installation
 ![alt text](image-14.png){ width=50% }
-The framework consists only of classes and interfaces and can be easily installed via abapGit – no additional app deployment is required. To communicate with the client, you simply create a new HTTP service.
+The framework consists solely of classes and interfaces, making it easy to install via abapGit, with no additional deployment required. Communication with the client is established by creating a new HTTP service.
 
 ##### Development
-UI5 apps are created by defining a new ABAP class and implementing a single method from the abap2UI5 interface. Each app is fully supported as an abapGit project, making installation across various systems straightforward.
+Creating UI5 applications in abap2UI5 is straightforward: define a new ABAP class and implement a single method from the abap2UI5 interface. Each app is fully supported as an abapGit project, allowing seamless installation across different systems.
 
 ##### Cloud Ready
-abap2UI5 relies solely on released APIs, making it suitable for on-stack and side-by-side extensions using the new ABAP for Cloud language version. In your app implementation, you have full freedom to use new features like CDS, ABAP SQL, and EML.
+abap2UI5 relies exclusively on released APIs, making it ideal for both on-stack and side-by-side extensions in the new ABAP for Cloud language version. Within your app, you’re free to utilize modern ABAP capabilities such as CDS, ABAP SQL, and EML.
 
 ##### Clean Core
-By ensuring your app only uses released APIs, your development remains "cloud-ready & upgrade-stable," adhering to clean core principles and ensuring future compatibility.
+By using only released APIs, abap2UI5 ensures your app is "cloud-ready and upgrade-stable," aligning with clean core principles and guaranteeing compatibility with future upgrades.
 
 ##### ABAP Classic
 The abap2UI5 framework does not use any newer ABAP syntax features. This makes it also compatible for on-premise and R/3 NetWeaver systems, enabling development in classic ABAP (Tier 3) extensions. A downported version is also available for systems below ABAP 7.50.
 
 ##### Architecture
-The abap2UI5 system footprint is kept minimal. In its base version, it includes only the essential classes and interfaces. Additional functionality can be added by installing optional addons.
+The abap2UI5 system footprint is kept minimal. The base version includes only essential classes and interfaces, and additional functionality can be incorporated by installing optional add-ons.
 
 ##### Security
-Since you manually create the HTTP handler for client communication, you have complete control over all external interactions, ensuring security.
+Since you configure the HTTP handler yourself, you retain complete control over all external communications, ensuring security.
 
-##### Use in Production
-abap2UI5 is an implementation of an HTTP handler and can be also used like any other HTTP service in a productive environment.
+##### Productive Usage
+As an implementation of an HTTP handler, abap2UI5 can be deployed in productive environments, similar to any other HTTP service.
 
 ##### Support
-Support is provided by the community on a best-effort basis. Submit an issue or join the abap2UI5 community on Slack for help. 
+Support for abap2UI5 is provided by the community on a best-effort basis. If you need assistance, submit an issue or join the abap2UI5 community on Slack.
 
 ##### Contribution
-Contributions are always welcome. Share your knowledge, hunt for or fix bugs, submit a pull request, expand this documentation, leave a comment, or help spread the word about abap2UI5. The project thrives on your involvement!
+Contributions are encouraged! Whether through bug fixes, feature additions, documentation enhancements, or community engagement, your involvement helps the project thrive. Consider submitting a pull request, sharing feedback, or helping spread the word about abap2UI5.
 
 ##### Sponsor
-abap2UI5 is maintained by dedicated developers volunteering their time. If you or your company use abap2UI5 in production but cannot contribute directly, consider supporting the project in other ways. More details can be found [here.](/resources/sponsor)
+abap2UI5 is maintained by dedicated developers who volunteer their time. If you or your company benefit from abap2UI5, but cannot contribute directly, please consider supporting the project in other ways. More details are available [here.](/resources/sponsor)

docs/get_started/next.md

@@ -1,18 +1,18 @@
 # What's Next?
 
-Expand your skills and explore more!
+Expand your skills and dive deeper into abap2UI5!
 
 #### Development
-Looking to sharpen your development skills? Explore advanced guides and best practices to take your abap2UI5 projects to the next level. Start learning [here.](/development/general)
+Want to level up your development skills? Explore advanced guides and best practices to elevate your abap2UI5 projects. Start learning [here.](/development/general)
 
 #### Configuration
-Ready to prepare abap2UI5 for production? Follow the configuration guides to ensure a smooth, optimized setup for your system. Get started [here.](/configuration/setup)
+Preparing abap2UI5 for production? Follow the configuration guides to ensure a smooth, optimized setup for your system. Begin [here.](/configuration/setup)
 
 #### Addons
-Enhance your abap2UI5 apps with additional features and functionalities by installing new add-ons. Discover them [here.](/addons/addons)
+Enhance your abap2UI5 applications with additional features and functionalities by installing new add-ons. Discover more [here.](/addons/addons)
 
 #### Apps
-Explore ready-to-use apps to jumpstart your projects. Find them [here.](/addons/apps)
+Jumpstart your projects by exploring ready-to-use apps. Find them [here.](/addons/apps)
 
 #### Blogs
-Gain more insights by checking out the latest blog posts. Dive into the community content [here.](/resources/blogs)
+Stay informed with the latest insights and community content. Check out the latest blog posts [here.](/resources/blogs)

docs/get_started/quickstart.md

@@ -16,7 +16,7 @@ Install the project with [abapGit.](https://abapgit.org)
 
 
 ### 2. Implement HTTP Handler
-Create a new package and define a new class for the HTTP implementation:
+Create a new package and define a new class for the HTTP handler implementation:
 
 ::: code-group
 
@@ -64,7 +64,7 @@ ENDCLASS.
 :::
 
 ### 3. Create HTTP Service
-Create a new HTTP service. Follow [this guide](https://developers.sap.com/tutorials/abap-environment-create-http-service..html) for ABAP Cloud.
+Create a new HTTP service for abap2UI5. For ABAP Cloud environments, follow [this guide.](https://developers.sap.com/tutorials/abap-environment-create-http-service..html)
 
 ![alt text](image-5.png)
 
@@ -75,10 +75,10 @@ Create a new HTTP service. Follow [this guide](https://developers.sap.com/tutori
 This project communicates solely with the HTTP service you define, giving you complete control over accessibility, authentication, and other security aspects.
 :::
 
-### 4. First Start
-The abap2UI5 framework and your custom HTTP handler have been successfully installed. You can now access the HTTP endpoint from your browser.
+### 4. Initial Launch
+After installing the abap2UI5 framework and configuring your HTTP handler, you can access the HTTP endpoint from a web browser:
 <img width="800" alt="image" src="https://github.com/user-attachments/assets/c8962298-068d-4efb-a853-c44a9b9cda56">
-Press check, and start the test app.
+Press "Check" and launch the test app. That’s it! Now you can create a new class and start developing your own abap2UI5 applications.
 
 
 

docs/get_started/use_cases.md

@@ -4,41 +4,34 @@ outline: [2, 4]
 
 # Use Cases
 
-abap2UI5 can be applied to a variety of use cases, whether you're working in a fully cloud-ready environment or using classic ABAP and calling unreleased APIs.
-
-Get an overview of all possibilities in [this article.](https://www.linkedin.com/pulse/use-cases-abap2ui5-overview-abap2ui5-udbde/?trackingId=6iIX%2FNk%2BCT0%2B4JorQjpRSQ%3D%3D)
+abap2UI5 can be applied to a variety of use cases, whether you’re working in a fully cloud-ready environment or using classic ABAP.
 
+Explore all possibilities in [this article.](https://www.linkedin.com/pulse/use-cases-abap2ui5-overview-abap2ui5-udbde/?trackingId=6iIX%2FNk%2BCT0%2B4JorQjpRSQ%3D%3D)
 
 ### On-Stack Extension
 
 #### Tier 1 Extension
-Development that respects the "keep the core clean" principles, ensuring your apps are cloud-ready and upgrade-stable.
+For clean-core compliance, develop applications that adhere to "keep the core clean" principles, ensuring that your apps are both cloud-ready and upgrade-stable:
 ![alt text](image-11.png){ width=60% }
 
 #### Tier 2 Extension
-If certain APIs are not yet released, you can still create a cloud-ready abap2UI5 app by calling these APIs through a separate Tier 2 wrapper:
+If certain APIs you need are not yet released, you can still create a cloud-ready abap2UI5 app by accessing these APIs through a separate Tier 2 wrapper:
 ![alt text](image-21.png){ width=60% }
 
 #### Tier 3 Extension
-Classic extension — use unreleased APIs and benefit from the freedom to make extensive changes to your system.
+For a classic extension approach, you can utilize unreleased APIs, allowing greater freedom to customize and extend your system:
 ![alt text](image-10.png){ width=60% }
 
 ### Side-by-Side Extension
 
 #### Tier 1 Extension
-Separate the development lifecycle of your apps from your S/4 system using only remote API calls. By only using released APIs your apps are also compatible to S/4 Public Cloud.
+Develop applications separately from your S/4 system’s lifecycle using only remote API calls. By using only released APIs, your apps will also be compatible with S/4HANA Public Cloud:
 ![alt text](image-22.png){ width=60% }
 
 #### Tier 3 Extension
-Separate the development lifecycle of your apps from your S/4 system using only remote API calls.
+For more flexibility, develop applications with an independent lifecycle from your S/4 system, while using remote API calls:
 ![alt text](image-23.png){ width=60% }
 
-### More
-
-#### Software as a Service
-Use the same code line across different S/4 systems.
+### Software as a Service
+With a Tier 1 side-by-side extension, you can connect the same abap2UI5 app to multiple S/4 systems. By using the same abap2UI5 code across different remote systems (and even different customers tenants), you create a SaaS scenario:
 ![alt text](image-9.png){ width=60% }
-
-#### Remote RFC
-Check out the RFC Connector in the addon section:
-![alt text](image-24.png){ width=60% }