Skip to content

docs(neo-migration): add @ui5/cli v4 upgrade guide and minUI5Version BWZ troubleshooting#181

Merged
longieirl merged 1 commit into
mainfrom
docs/neo-migration-ui5-cli-v4-minui5version
Jul 9, 2026
Merged

docs(neo-migration): add @ui5/cli v4 upgrade guide and minUI5Version BWZ troubleshooting#181
longieirl merged 1 commit into
mainfrom
docs/neo-migration-ui5-cli-v4-minui5version

Conversation

@longieirl

Copy link
Copy Markdown
Member

Summary

  • Adds ## Upgrading @ui5/cli to v4 section (between Extension Projects and Troubleshooting) covering Node.js requirements, install command, and breaking changes (usePredefineCalls removal, async require default change)
  • Adds ### Application Fails to Load in SAP Build Work Zone Due to Outdated minUI5Version troubleshooting entry explaining the local-vs-BWZ version mismatch, how to replicate using sap.ui.version in Chrome DevTools console, and the fix: align both minUI5Version and the root _version in manifest.json using the UI5 manifest version mapping
  • Fixes MD012/MD022 markdown lint errors (double blank line, missing blank line after heading)
  • Applies KM style fixes: SAP product name prefix, future tense → present, removes currently, fixes dangling participle, backtick-wraps npm, standardises link intro phrasing, corrects _version location description

Test plan

  • Markdown lint passes (./scripts/lint-markdown.sh neo-migration/README.md)
  • New ## Upgrading @ui5/cli to v4 section appears between Extension Projects and Troubleshooting
  • BWZ minUI5Version troubleshooting entry appears under Troubleshooting
  • All links resolve (Migrate to v4, SAPUI5 Versions Maintenance Status, UI5 Manifest Version Mapping)

@longieirl longieirl self-assigned this Jul 9, 2026
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown

🔗 Link Check Results

The link checker has completed. This is an optional check and will not block the PR.

View workflow run for details

If broken links were found, please review them at your convenience.


Last updated: Run #259 at 2026-07-06T18:49:40Z

…BWZ issue

- Add new '## Upgrading @ui5/cli to v4' section between Extension Projects
  and Troubleshooting covering Node.js requirements, install command, and
  breaking changes (usePredefineCalls removal, async require default)
- Add troubleshooting entry for apps failing in SAP Build Work Zone due to
  outdated minUI5Version, including how to replicate via sap.ui.version in
  Chrome console and fix by aligning both minUI5Version and manifest _version
  using the UI5 manifest version mapping
- Fix MD012/MD022 lint errors (double blank line, missing blank after heading)
- Apply KM style fixes: SAP prefix on product names, future tense, currently,
  dangling participle, npm backticks, refer to → see, incorrect _version location

Co-Authored-By: Claude <noreply@anthropic.com>
@longieirl longieirl force-pushed the docs/neo-migration-ui5-cli-v4-minui5version branch from eef646f to 34aefeb Compare July 9, 2026 10:15
@longieirl longieirl merged commit cccb9b2 into main Jul 9, 2026
4 checks passed
@github-actions github-actions Bot deleted the docs/neo-migration-ui5-cli-v4-minui5version branch July 9, 2026 10:37
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.

1 participant