Skip to content

Write the translator as npx --no-install cap2ui5 abap2js - #35

Merged
oblomov-dev merged 1 commit into
mainfrom
claude/cool-heisenberg-r1cmh3
Sep 29, 2026
Merged

oblomov-dev merged 1 commit into
mainfrom
claude/cool-heisenberg-r1cmh3

Conversation

@oblomov-dev

Copy link
Copy Markdown
Member

Why

The cap2ui5 command is a bin of the scoped package @cap2ui5/cds-plugin. The unscoped npm name cap2ui5 was withdrawn and can be published by anyone. Where the plugin is not installed, a bare npx cap2ui5 abap2js … downloads and runs whatever npm has under that name. With --no-install, npx runs the project's own @cap2ui5/cds-plugin bin or fails, and never downloads.

cap2UI5/cap2UI5 already follows this rule in plugin/README.md and AGENTS.md. This PR makes the site match.

Changes

  • Every bare npx cap2ui5 in the site sources now reads npx --no-install cap2ui5. That is 11 places across the guide pages and the architecture reference.
  • Migration page
    • The heading is now "Translate it: cap2ui5 abap2js", matching the plugin README's heading.
    • Its anchor is now #translate-it-cap2ui5-abap2js, and the 4 internal links point to it.
    • The link to the plugin README now uses the README's current anchor. The old one no longer existed there.
    • The code block installs @abaplint/core first, as the README does, because the plugin has it only as an optional peer dependency.
    • A new note says the command needs @cap2ui5/cds-plugin installed in the project, and that in a package.json script the command is a plain cap2ui5 abap2js ….
  • AGENTS.md: the two mentions of the command are updated, and a new rule is added. It says to always use --no-install and to leave cds add cap2ui5, package.json scripts and npx -p @cap2ui5/cds-plugin cap2ui5 … as they are.

Outside links to the old section anchor #translate-it-npx-cap2ui5-abap2js will now land at the top of the page instead of on the section.

Checks

npm run check:ci passes, with cap2UI5/cap2UI5 and abap2UI5 checked out:

verify-refs: OK — every documented path, class, app id and option resolves
build complete

🤖 Generated with Claude Code

https://claude.ai/code/session_017qE7GHShC7hMeY88tFr3wj


Generated by Claude Code

The unscoped npm name cap2ui5 was withdrawn and can be published by
anyone. Where the plugin is not installed, a bare `npx cap2ui5 abap2js`
downloads and runs whatever npm has under that name. With --no-install,
npx runs the project's own @cap2ui5/cds-plugin bin or fails.

- Every bare `npx cap2ui5` on the site now reads
  `npx --no-install cap2ui5`.
- The migration page's heading is now "Translate it: `cap2ui5 abap2js`",
  matching the plugin README. Its anchor and the README anchor it links
  to changed with it, and the internal links point to the new anchor.
- The migration page now installs @abaplint/core before the command and
  says the command needs @cap2ui5/cds-plugin installed.
- AGENTS.md now has this as a rule.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017qE7GHShC7hMeY88tFr3wj
@oblomov-dev
oblomov-dev merged commit 5637741 into main Sep 29, 2026
1 check passed
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