Skip to content

Commit 241c7ab

Browse files
committed
docs: consolidate AI guidance on the AI page only
1 parent ece4503 commit 241c7ab

2 files changed

Lines changed: 1 addition & 5 deletions

File tree

docs/cookbook/view/definition.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -132,10 +132,6 @@ Every fluent helper ultimately produces an XML element. The lowest-level method
132132

133133
This maps **1:1** to the UI5 XML/SDK API — control names, property names, and aggregation names are written exactly as they appear in the [UI5 SDK](https://sapui5.hana.ondemand.com), in their original camelCase. There is no abstraction layer guessing what to call things.
134134

135-
::: tip Recommended for AI-assisted Development
136-
For AI-assisted coding, prefer the generic builder. It removes the need for the model to know the abap2UI5 naming conventions or guess which controls and properties are wrapped — the SDK documentation can be used directly. The fluent API in `Z2UI5_CL_XML_VIEW` is convenient for humans but its inconsistencies and incomplete coverage make it a poor target for code generation.
137-
:::
138-
139135
The rest of this documentation uses the higher-level fluent API (`->page( )`, `->button( )`, `->multi_combo_box( )`) because it reads better in examples. Both styles can be mixed freely in the same view.
140136

141137
#### Next Steps

docs/get_started/ai.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ Views are UI5 XML strings passed to `client->view_display( ... )`. The framework
104104
- **`z2ui5_cl_util_xml`** — generic XML builder. Element name + attributes as strings → maps **1:1** to the UI5 SDK. **Recommended for AI-generated code.**
105105
- **`z2ui5_cl_xml_view`** — fluent builder with one ABAP method per UI5 control (~446 methods). Convenient for humans, but has naming inconsistencies and incomplete coverage → harder for an AI to use correctly.
106106

107-
[View Definition + AI Tip](/cookbook/view/definition#recommended-for-ai-assisted-development)
107+
[View Definition](/cookbook/view/definition)
108108

109109
## Recommended Builder for AI: `z2ui5_cl_util_xml`
110110

0 commit comments

Comments
 (0)