Merge pull request #111 from abap2UI5/claude/wizardly-mccarthy-bqrgx

Reorganize documentation: move AI and Add-ons to Advanced section

Author: oblomov-dev

docs/.vitepress/config.mjs

@@ -64,7 +64,7 @@ export default defineConfig({
           { text: "Configuration", link: "/configuration/setup" },
           { text: "Advanced Topic", link: "/advanced/downporting" },
           { text: "Technical Insight", link: "/technical/concept" },
-          { text: "Resource", link: "/resources/addons" },
+          { text: "Resource", link: "/resources/references" },
         ],
       },
       {
@@ -114,7 +114,6 @@ export default defineConfig({
               { text: "Full Example", link: "/get_started/full_example" },
             ],
           },
-          { text: "AI-Assisted Development", link: "/get_started/ai" },
           { text: `What's Next?`, link: "/get_started/next" },
         ],
       },
@@ -339,6 +338,8 @@ export default defineConfig({
         link: "/advanced/downporting",
         collapsed: true,
         items: [
+          { text: "AI-Assisted Development", link: "/advanced/agent" },
+          { text: "Add-ons", link: "/advanced/addons" },
           { text: "Downporting", link: "/advanced/downporting" },
           { text: "Renaming", link: "/advanced/renaming" },
           { text: "Build Process", link: "/advanced/builds" },
@@ -399,10 +400,9 @@ export default defineConfig({
       },
       {
         text: "Resource",
-        link: "/resources/addons",
+        link: "/resources/references",
         collapsed: true,
         items: [
-          { text: "Add-on", link: "/resources/addons" },
           { text: "Reference", link: "/resources/references" },
           { text: "Who Uses abap2UI5?", link: "/resources/who_uses" },
           { text: "Release", link: "/resources/changelog" },

docs/resources/addons.md docs/advanced/addons.mddocs/resources/addons.md renamed to docs/advanced/addons.md

@@ -252,7 +252,7 @@ When an AI needs deeper information than this page provides:
 
 A prompt that gives an AI assistant enough context to produce a working app:
 
-> You are building an abap2UI5 app. Read <https://abap2ui5.github.io/docs/get_started/ai.html> first — it is the single source of truth for app-building (template, client API, lifecycle, view builder, deprecated controls, documentation map). For working examples, browse <https://github.com/abap2UI5/samples/tree/main/src> (250+ apps, one feature per app). Use `z2ui5_cl_util_xml` as the view builder. Look up any UI5 control at <https://ui5.sap.com/#/api> and translate the XML 1:1 to ABAP. Do not use any control listed in this page's "Deprecated UI5 Controls" section.
+> You are building an abap2UI5 app. Read <https://abap2ui5.github.io/docs/advanced/agent.html> first — it is the single source of truth for app-building (template, client API, lifecycle, view builder, deprecated controls, documentation map). For working examples, browse <https://github.com/abap2UI5/samples/tree/main/src> (250+ apps, one feature per app). Use `z2ui5_cl_util_xml` as the view builder. Look up any UI5 control at <https://ui5.sap.com/#/api> and translate the XML 1:1 to ABAP. Do not use any control listed in this page's "Deprecated UI5 Controls" section.
 
 ## Hard Rules (Cheat Sheet)
 

docs/get_started/ai.md docs/advanced/agent.mddocs/get_started/ai.md renamed to docs/advanced/agent.md

@@ -146,4 +146,4 @@ ENDCLASS.
 For a complete sound sample, see `Z2UI5_CL_DEMO_APP_304`.
 
 #### Render Barcodes
-To also render barcodes, use bwip-js, which ships with the js-libraries add-on. See [Add-ons](/resources/addons) for details.
+To also render barcodes, use bwip-js, which ships with the js-libraries add-on. See [Add-ons](/advanced/addons) for details.

docs/cookbook/device_capabilities/barcode_scanning.md

@@ -281,4 +281,4 @@ ENDCLASS.
 :::
 
 #### UI5 Control
-To export data directly on the frontend, SAP offers the sap.ui.export.Spreadsheet control for exporting table content. With some extra logic, you can use this control with abap2UI5 too. See the [Add-ons](/resources/addons) page for a complete sample with the custom control. The coding effort may be higher than the file-based approach shown above.
+To export data directly on the frontend, SAP offers the sap.ui.export.Spreadsheet control for exporting table content. With some extra logic, you can use this control with abap2UI5 too. See the [Add-ons](/advanced/addons) page for a complete sample with the custom control. The coding effort may be higher than the file-based approach shown above.

docs/cookbook/device_capabilities/spreadsheet.md

@@ -1080,7 +1080,7 @@ ENDCLASS.
 On modern releases, RAP draft-enabled business objects manage locking for you: the draft holds an exclusive lock for its owner while the user keeps editing — no stateful session, no `ENQUEUE_*` call. If a released SAP BO already covers your object, this is usually the simplest path. See [Draft Handling](../eml_cds_sql/draft_handling.md).
 
 #### 8. Lock-Manager Add-on
-The community add-on [**lock-manager**](https://github.com/abap2UI5-addons/lock-manager) wraps the lock logic in a reusable class — including stale-lock cleanup and a "locked by X since…" message for the user. Install it like any other [add-on](../../resources/addons.md) and call it instead of writing the boilerplate yourself.
+The community add-on [**lock-manager**](https://github.com/abap2UI5-addons/lock-manager) wraps the lock logic in a reusable class — including stale-lock cleanup and a "locked by X since…" message for the user. Install it like any other [add-on](../../advanced/addons.md) and call it instead of writing the boilerplate yourself.
 
 #### Overview
 

docs/cookbook/expert_more/lock.md

@@ -85,7 +85,7 @@ Pass `i_multiselect = abap_true` for multi-pick; the result table is then in `ls
 
 #### DDIC Search Help
 
-For value helps that exist as DDIC search help objects (`SE11` → search help), the [generic search help builder](https://github.com/axelmohnen/a2UI5-generic_search_hlp) wraps the F4 framework so you can fire any standard search help by name and get the picked row back. Install it like any other [add-on](../../resources/addons.md).
+For value helps that exist as DDIC search help objects (`SE11` → search help), the [generic search help builder](https://github.com/axelmohnen/a2UI5-generic_search_hlp) wraps the F4 framework so you can fire any standard search help by name and get the picked row back. Install it like any other [add-on](../../advanced/addons.md).
 
 #### Custom Dialog
 

docs/cookbook/expert_more/value_help.md

@@ -29,6 +29,8 @@ Since launching in 2023, abap2UI5 has grown from a small side project into a com
 
 → *See [Sample Apps](/get_started/next#sample-apps) to watch abap2UI5 in action*
 
+→ *Building with an AI assistant? See [AI-Assisted Development](/advanced/agent)*
+
 ### Why abap2UI5?
 
 Traditional UI5 development needs JavaScript expertise, frontend deployment, and OData service setup. abap2UI5 cuts out those complexities:

docs/get_started/about.md

@@ -23,7 +23,7 @@ Build views, handle events, share data, and work with tables. The [Cookbook](/co
 Before going live, set up security, performance tuning, Launchpad integration, and more. Start with the [Configuration guide](/configuration/setup).
 
 #### Add-ons
-Extend your apps with community-built add-ons for layout handling, charts, table maintenance, and more. See the [Add-ons page](/resources/addons).
+Extend your apps with community-built add-ons for layout handling, charts, table maintenance, and more. See the [Add-ons page](/advanced/addons).
 
 #### Real-World Use
 See ready-to-use apps, real-world scenarios, and companies already running on abap2UI5 on the [Who Uses abap2UI5](/resources/who_uses) page.