Merge branch 'main' into claude/add-http-connector-page-Qy3Qe

Author: oblomov-dev

docs/.vitepress/config.mjs

@@ -120,18 +120,18 @@ export default defineConfig({
           { text: "Controller", link: "/development/general" },
           {
             text: "View",
-            link: "/development/view",
             collapsed: true,
             items: [
+              { text: "Definition", link: "/development/view/definition" },
               { text: "Expression Binding", link: "/development/model/expression_binding" },
               { text: "Formatter", link: "/development/specific/formatter" },
             ],
           },
           {
             text: "Model",
-            link: "/development/model/model",
             collapsed: true,
             items: [
+              { text: "Binding", link: "/development/model/binding" },
               { text: "Tables, Trees", link: "/development/model/tables" },
               { text: "Device Model", link: "/development/model/device" },
               { text: "OData", link: "/development/model/odata" },
@@ -150,7 +150,15 @@ export default defineConfig({
               },
             ],
           },
-          { text: "Messages, Errors", link: "/development/messages" },
+          {
+            text: "Messages, Errors",
+            collapsed: true,
+            items: [
+              { text: "Messages", link: "/development/messages/messages" },
+              { text: "Errors", link: "/development/messages/errors" },
+              { text: "Logging", link: "/development/messages/logging" },
+            ],
+          },
           { text: "Translation, i18n", link: "/development/translation" },
           { text: "Popups, Popovers", link: "/development/popups" },
           {
@@ -175,9 +183,17 @@ export default defineConfig({
                 text: "Geolocation, Maps",
                 link: "/development/specific/geolocation",
               },
-              { text: "File Handling", link: "/development/specific/files" },
+              {
+                text: "File Handling",
+                link: "/development/specific/files",
+                collapsed: true,
+                items: [
+                  { text: "XLSX", link: "/development/specific/xlsx" },
+                ],
+              },
               { text: "URL", link: "/development/specific/url" },
               { text: "Timer", link: "/development/specific/timer" },
+              { text: "Soft Keyboard", link: "/development/specific/soft_keyboard" },
             ],
           },
           {
@@ -196,13 +212,10 @@ export default defineConfig({
             text: "Misc Topics",
             collapsed: true,
             items: [
-              { text: "Logging", link: "/development/specific/logging" },
-              { text: "XLSX", link: "/development/specific/xlsx" },
               { text: "Locks", link: "/development/specific/locks" },
               { text: "Statefulness", link: "/development/specific/statefulness" },
             ],
           },
-          { text: "Troubleshooting", link: "/development/trouble" },
         ],
       },
       {

docs/development/messages/errors.md

@@ -0,0 +1,42 @@
+---
+outline: [2, 4]
+---
+# Errors
+
+Beyond plain messages, abap2UI5 ships dedicated popups and fallbacks for handling exceptions and unexpected failures.
+
+#### Error Popup
+To display full details of your exception:
+```abap
+METHOD z2ui5_if_app~main.
+
+  TRY.
+    DATA(lv_val) = 1 / 0.
+  CATCH cx_root INTO DATA(lx).
+    client->nav_app_call( z2ui5_cl_pop_error=>factory( lx ) ).
+  ENDTRY.
+
+ENDMETHOD.
+```
+
+#### Uncaught Errors
+When your code doesn't catch exceptions, the framework catches them and displays the standard error popup. Try this:
+
+```abap
+METHOD z2ui5_if_app~main.
+
+    RAISE EXCEPTION NEW cx_sy_itab_line_not_found( ).
+
+ENDMETHOD.
+```
+
+#### Uncatchable Exceptions / Short Dumps
+What happens if your code raises uncatchable exceptions? The default HTTP handler exception output appears. Processing halts, and the user has to reload the browser. Reserve this for unexpected cases:
+
+```abap
+METHOD z2ui5_if_app~main.
+
+    ASSERT 1 = `This is an error message!`.
+
+ENDMETHOD.
+```

docs/development/specific/logging.md docs/development/messages/logging.mddocs/development/specific/logging.md renamed to docs/development/messages/logging.md

@@ -1,9 +1,9 @@
 ---
 outline: [2, 5]
 ---
-# Messages, Errors
+# Messages
 
-Showing messages and errors is an everyday task for ABAP developers. The functions below cover the most common cases.
+Showing messages is an everyday task for ABAP developers. The functions below cover the most common cases.
 
 #### Message Toast
 
@@ -86,41 +86,6 @@ METHOD z2ui5_if_app~main.
 
   client->nav_app_call( z2ui5_cl_pop_messages=>factory( lt_msg ) ).
 
-ENDMETHOD.
-```
-#### Error Popup
-To display full details of your exception:
-```abap
-METHOD z2ui5_if_app~main.
-
-  TRY.
-    DATA(lv_val) = 1 / 0.
-  CATCH cx_root INTO DATA(lx).
-    client->nav_app_call( z2ui5_cl_pop_error=>factory( lx ) ).
-  ENDTRY.
-
-ENDMETHOD.
-```
-
-#### Uncaught Errors
-When your code doesn't catch exceptions, the framework catches them and displays the standard error popup. Try this:
-
-```abap
-METHOD z2ui5_if_app~main.
-
-    RAISE EXCEPTION NEW cx_sy_itab_line_not_found( ).
-
-ENDMETHOD.
-```
-
-#### Uncatchable Exceptions / Short Dumps
-What happens if your code raises uncatchable exceptions? The default HTTP handler exception output appears. Processing halts, and the user has to reload the browser. Reserve this for unexpected cases:
-
-```abap
-METHOD z2ui5_if_app~main.
-
-    ASSERT 1 = `This is an error message!`.
-
 ENDMETHOD.
 ```
 

docs/development/messages.md docs/development/messages/messages.mddocs/development/messages.md renamed to docs/development/messages/messages.md

@@ -1,7 +1,7 @@
 ---
 outline: [2, 4]
 ---
-# Model
+# Binding
 
 In abap2UI5, there are two ways to share data between your ABAP code and the UI5 frontend.
 

docs/development/model/model.md docs/development/model/binding.mddocs/development/model/model.md renamed to docs/development/model/binding.md

@@ -1,7 +1,7 @@
 ---
 outline: [2, 4]
 ---
-# Troubleshooting
+# Soft Keyboard
 
 #### Hide Soft Keyboard
 

docs/development/trouble.md …cs/development/specific/soft_keyboard.mddocs/development/trouble.md renamed to docs/development/specific/soft_keyboard.md docs/development/trouble.md renamed to docs/development/specific/soft_keyboard.md

@@ -1,7 +1,7 @@
 ---
 outline: [2, 4]
 ---
-# View
+# Definition
 
 In abap2UI5, UI5 renders the UI from an XML view that you build in ABAP. A simple example with raw XML: