add troubleshooting

Author: oblomov-dev

docs/.vitepress/config.mjs

@@ -164,6 +164,7 @@ export default defineConfig({
               { text: "cl_demo_output", link: "/development/specific/demo_output" },
             ],
           },
+          { text: "Troubleshooting", link: "/development/trouble" },
         ],
       },
       {

docs/development/trouble.md

@@ -0,0 +1,50 @@
+# Troubleshooting
+
+#### Hide Soft Keyboard
+
+For UI5 input fields, the soft keyboard is automatically shown when focusing an input field. In some use cases, e.g. in the context of warehouses with small devices, this is not always wanted. To change this behavior, we have to adjust the HTML input element and switch the input type to `none`. The following snippet demonstrates how to activate/deactivate the soft keyboard:
+
+```abap
+
+  METHOD z2ui5_if_app~main.
+
+    IF client->check_on_init( ).
+    
+    DATA(view) = z2ui5_cl_xml_view=>factory( ).
+    view->_generic( name = `script`
+                    ns   = `html` )->_cc_plain_xml( `z2ui5.afterBE = (id , mode) => { ` &&
+                       `debugger;` &&
+                        `var input = z2ui5.oView.byId(id).getDomRef();` &&
+                        `input = input.childNodes[0].childNodes[0];` &&
+                        `input.setAttribute("inputmode" , mode);` &&
+                        ` alert("inputmode changed to" + mode); }` ).
+
+    DATA(page) =   view->shell(
+             )->page( title          = 'abap2UI5 - Softkeyboard on/off'
+                      navbuttonpress = client->_event( 'BACK' )
+                      shownavbutton  = client->check_app_prev_stack( )
+                      )->_z2ui5( )->focus( focusid = `ZINPUT`
+      )->simple_form( editable = abap_true
+                 )->content( 'form'
+                     )->title( 'Keyboard on/off'
+                     )->label( 'Input'
+                     )->input( id               = `ZINPUT`
+                               value            = client->_bind_edit( input )
+                               showvaluehelp    = abap_true
+                               valuehelprequest = client->_event( 'CALL_KEYBOARD' )
+                               valuehelpiconsrc = 'sap-icon://keyboard-and-mouse' ).
+
+    client->view_display( page->stringify( ) ).
+
+    ENDIF.
+
+
+    CASE client->get( )-event.
+      WHEN 'CALL_KEYBOARD'.
+        client->follow_up_action( `z2ui5.afterBE("ZINPUT", "none");` ).
+      WHEN 'BACK'.
+        client->nav_app_leave( ).
+    ENDCASE.
+
+  ENDMETHOD.
+```

docs/get_started/about.md

@@ -30,12 +30,12 @@ Since launching in 2023, abap2UI5 has evolved from a small side project into a c
 
 ### Why abap2UI5?
 
-Traditional UI5 development requires JavaScript expertise, frontend deployment, and OData service configuration. abap2UI5 cuts through these complexities, making it perfect for:
+Traditional UI5 development requires JavaScript expertise, frontend deployment, and OData service configuration. abap2UI5 cuts through these complexities:
 
-- **Leveraging your existing ABAP skills** - do what you know best, keep it simple, keep it ABAP
-- **Extending beyond RAP** – when RAP capabilities reach their limits
-- **Rapid prototyping** – quick iteration on new business applications
-- **Modernizing legacy applications** – no need to rewrite business logic
+- **Leverage your existing ABAP skills** – do what you know best, keep it simple, keep it ABAP
+- **Extend beyond RAP** – when RAP capabilities reach their limits
+- **Prototype rapidly** – quick iteration on new business applications
+- **Modernize legacy apps** – no need to rewrite business logic
 
 Each application is packaged as an [abapGit](https://abapgit.org) project, simplifying installation across systems without separate frontend deployments.