docs: document Shopware CLI Administration migration checks

[somethings (lasomethingsomething)]

Summary

Document the Shopware CLI's built-in Administration migration checks and fixes.

• Add a dedicated CLI reference page for Administration migrations.
• Explain how project fix and extension fix apply the supported rules.
• Document the bounded scope and limitations of the migration rules.
• Link the new page from the automatic refactoring documentation.
• Link the CLI capability from the Administration migration guide.

Related links

See comment in #1372

Checklist

• I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
• I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted.
• I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms.
• Any required dependent changes in downstream modules have already been merged and published.
• This pull request is ready for review.

Notes

This intentionally documents the capability and its scope without duplicating the complete rule implementation from Shopware CLI.

[shopware-dev-docs-connector]

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: 9a6ad60
Preview: https://developer-documentation-2q4orjadb-shopware-frontends.vercel.app
Workflow run: #5020

[github-actions]

📢 Developer Announcement Recommendation

Recommendation: ❌ No Announcement Recommended

No developer announcement signals were detected.

This PR does not appear to introduce developer-facing changes that require a community announcement.

[github-actions]

📢 Developer Announcement Recommendation

Recommendation: ❌ No Announcement Recommended

No developer announcement signals were detected.

This PR does not appear to introduce developer-facing changes that require a community announcement.

[Copilot]

Pull request overview

This PR adds documentation for Shopware CLI’s built-in Administration migration checks/fixes and cross-links it from existing upgrade and refactoring docs, clarifying when and how to use the fixer and what its limitations are.

Changes:

• Added a new CLI reference page describing Administration migration checks (project fix / extension fix) and their bounded scope.
• Linked the new reference from the CLI automatic refactoring documentation.
• Linked the CLI capability from the Administration upgrade/migration guide index.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
products/tools/cli/automatic-refactoring.md	Adds a pointer to the new Administration migrations reference page.
products/tools/cli/administration-migrations.md	Introduces the new reference page documenting the fixer commands, scope, and limitations.
guides/upgrades-migrations/administration/index.md	Adds a cross-link to the CLI reference for automated detection/fixing.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Soner (shyim)]

For me this page feels like useless 🙈 . I read it twice and still don't know for what it is and which value it gives over the already existing automatic refactoring page 🙈

[Micha Hobert (Isengo1989)]

Agree, the commands are now explained in both files. Maybe add some details to the existing page instead?

[somethings (lasomethingsomething)]

Soner (@shyim) Micha Hobert (@Isengo1989) Hopefully RoboApple has fixed the issue -- thanks for the catch!