Skip to content

Clarify embed control, build process, and delivery architecture - #91

Merged
oblomov-dev merged 1 commit into
mainfrom
claude/trusting-bardeen-43cc1c
Oct 12, 2026
Merged

oblomov-dev merged 1 commit into
mainfrom
claude/trusting-bardeen-43cc1c

Conversation

@oblomov-dev

Copy link
Copy Markdown
Member

What changes

Documentation updates across AGENTS.md, README.md, CONTRIBUTING.md, and workflow files to clarify:

  1. The embed control separation: z2ui5.embed.Container is developed and published separately in abap2UI5/embed-control, not in abap2UI5 or this repository. Added a new "The embed control" section to AGENTS.md explaining the control's source, versioning, and deployment identity.

  2. Build process accuracy: Corrected the description of how branches are built. The build happens at deploy time into git-ignored tools/out/, not into a committed build/ directory. No delivery trees are committed in abap2UI5 — frontend_check builds on pull requests, frontend_deploy builds on main and stamps the result.

  3. The _new branches: Clarified that cloud_new and standard_new carry no copy of the abap2UI5 frontend. Their app is in frontend/embed/ and loads the frontend from the backend at runtime via the embed control, eliminating the need to pull frontend updates separately.

  4. Routing guidance: Updated pull request template, guard workflow, and CONTRIBUTING.md to direct changes to the correct repositories:

    • webapp changes → abap2UI5 app/webapp/
    • _new branch app changes → abap2UI5 frontend/embed/
    • embed control changes → abap2UI5/embed-control

Why

The previous documentation conflated the build process (suggesting committed build/ trees) with the actual git-ignored tools/out/ build artifacts, and did not clearly explain that the embed control is a separate project with its own repository and npm package. This caused confusion about where changes belong and how the delivery pipeline actually works.

Why this belongs in this repository

This is a documentation-only change to this repository's own docs (AGENTS.md, README.md, CONTRIBUTING.md, and workflow comments). These files are maintained here and not generated. No changes to generated content or build logic.

Requesting 'maintenance' label to unlock the guard check.

https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL

…2UI5

README (held byte-identical to abap2UI5's frontend/common/README.md),
CONTRIBUTING, AGENTS.md and the deliver comment still described the six
trees as committed under build/ in abap2UI5. Nothing is committed there:
frontend_check builds into tools/out/ on the pull request and
frontend_deploy runs the same build on main, which is where the stamped
trees come from. AGENTS.md gets a section on the two kinds of branch:
the classic ones carrying a copy of app/webapp, and standard_new /
cloud_new carrying one z2ui5.embed.Container that loads the frontend
from the backend - with the app in frontend/embed, the control in
abap2UI5/embed-control (pinned as @abap2ui5/embed-control), and the
deployment identity both kinds share. CONTRIBUTING, the guard message
and the pull request template name the same two places.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL
@oblomov-dev
oblomov-dev merged commit 2c5e360 into main Oct 12, 2026
1 check failed
@oblomov-dev
oblomov-dev deleted the claude/trusting-bardeen-43cc1c branch October 12, 2026 07:23
github-actions Bot added a commit that referenced this pull request Oct 12, 2026
…2UI5 (#91)

README (held byte-identical to abap2UI5's frontend/common/README.md),
CONTRIBUTING, AGENTS.md and the deliver comment still described the six
trees as committed under build/ in abap2UI5. Nothing is committed there:
frontend_check builds into tools/out/ on the pull request and
frontend_deploy runs the same build on main, which is where the stamped
trees come from. AGENTS.md gets a section on the two kinds of branch:
the classic ones carrying a copy of app/webapp, and standard_new /
cloud_new carrying one z2ui5.embed.Container that loads the frontend
from the backend - with the app in frontend/embed, the control in
abap2UI5/embed-control (pinned as @abap2ui5/embed-control), and the
deployment identity both kinds share. CONTRIBUTING, the guard message
and the pull request template name the same two places.


Claude-Session: https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL

Co-authored-by: Claude <noreply@anthropic.com>
github-actions Bot added a commit that referenced this pull request Oct 12, 2026
…2UI5 (#91)

README (held byte-identical to abap2UI5's frontend/common/README.md),
CONTRIBUTING, AGENTS.md and the deliver comment still described the six
trees as committed under build/ in abap2UI5. Nothing is committed there:
frontend_check builds into tools/out/ on the pull request and
frontend_deploy runs the same build on main, which is where the stamped
trees come from. AGENTS.md gets a section on the two kinds of branch:
the classic ones carrying a copy of app/webapp, and standard_new /
cloud_new carrying one z2ui5.embed.Container that loads the frontend
from the backend - with the app in frontend/embed, the control in
abap2UI5/embed-control (pinned as @abap2ui5/embed-control), and the
deployment identity both kinds share. CONTRIBUTING, the guard message
and the pull request template name the same two places.


Claude-Session: https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL

Co-authored-by: Claude <noreply@anthropic.com>
github-actions Bot added a commit that referenced this pull request Oct 12, 2026
…2UI5 (#91)

README (held byte-identical to abap2UI5's frontend/common/README.md),
CONTRIBUTING, AGENTS.md and the deliver comment still described the six
trees as committed under build/ in abap2UI5. Nothing is committed there:
frontend_check builds into tools/out/ on the pull request and
frontend_deploy runs the same build on main, which is where the stamped
trees come from. AGENTS.md gets a section on the two kinds of branch:
the classic ones carrying a copy of app/webapp, and standard_new /
cloud_new carrying one z2ui5.embed.Container that loads the frontend
from the backend - with the app in frontend/embed, the control in
abap2UI5/embed-control (pinned as @abap2ui5/embed-control), and the
deployment identity both kinds share. CONTRIBUTING, the guard message
and the pull request template name the same two places.


Claude-Session: https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL

Co-authored-by: Claude <noreply@anthropic.com>
github-actions Bot added a commit that referenced this pull request Oct 12, 2026
…2UI5 (#91)

README (held byte-identical to abap2UI5's frontend/common/README.md),
CONTRIBUTING, AGENTS.md and the deliver comment still described the six
trees as committed under build/ in abap2UI5. Nothing is committed there:
frontend_check builds into tools/out/ on the pull request and
frontend_deploy runs the same build on main, which is where the stamped
trees come from. AGENTS.md gets a section on the two kinds of branch:
the classic ones carrying a copy of app/webapp, and standard_new /
cloud_new carrying one z2ui5.embed.Container that loads the frontend
from the backend - with the app in frontend/embed, the control in
abap2UI5/embed-control (pinned as @abap2ui5/embed-control), and the
deployment identity both kinds share. CONTRIBUTING, the guard message
and the pull request template name the same two places.


Claude-Session: https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL

Co-authored-by: Claude <noreply@anthropic.com>
github-actions Bot added a commit that referenced this pull request Oct 12, 2026
…2UI5 (#91)

README (held byte-identical to abap2UI5's frontend/common/README.md),
CONTRIBUTING, AGENTS.md and the deliver comment still described the six
trees as committed under build/ in abap2UI5. Nothing is committed there:
frontend_check builds into tools/out/ on the pull request and
frontend_deploy runs the same build on main, which is where the stamped
trees come from. AGENTS.md gets a section on the two kinds of branch:
the classic ones carrying a copy of app/webapp, and standard_new /
cloud_new carrying one z2ui5.embed.Container that loads the frontend
from the backend - with the app in frontend/embed, the control in
abap2UI5/embed-control (pinned as @abap2ui5/embed-control), and the
deployment identity both kinds share. CONTRIBUTING, the guard message
and the pull request template name the same two places.


Claude-Session: https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL

Co-authored-by: Claude <noreply@anthropic.com>
github-actions Bot added a commit that referenced this pull request Oct 12, 2026
…2UI5 (#91)

README (held byte-identical to abap2UI5's frontend/common/README.md),
CONTRIBUTING, AGENTS.md and the deliver comment still described the six
trees as committed under build/ in abap2UI5. Nothing is committed there:
frontend_check builds into tools/out/ on the pull request and
frontend_deploy runs the same build on main, which is where the stamped
trees come from. AGENTS.md gets a section on the two kinds of branch:
the classic ones carrying a copy of app/webapp, and standard_new /
cloud_new carrying one z2ui5.embed.Container that loads the frontend
from the backend - with the app in frontend/embed, the control in
abap2UI5/embed-control (pinned as @abap2ui5/embed-control), and the
deployment identity both kinds share. CONTRIBUTING, the guard message
and the pull request template name the same two places.


Claude-Session: https://claude.ai/code/session_01NMqeR6v28CHcmUTCNMKZjL

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants