chore: updates from Feb 2026 DX Tools mtg notes#2380
Open
somethings (lasomethingsomething) wants to merge 17 commits into
Open
chore: updates from Feb 2026 DX Tools mtg notes#2380somethings (lasomethingsomething) wants to merge 17 commits into
somethings (lasomethingsomething) wants to merge 17 commits into
Conversation
Developer Docs healthcheckStatus: Completed with |
Copilot started reviewing on behalf of
somethings (lasomethingsomething)
July 16, 2026 12:00
View session
Contributor
There was a problem hiding this comment.
Pull request overview
This PR applies a set of small documentation refinements across the Shopware developer docs, primarily to improve discoverability (more cross-links and “start here” tables) and to clarify recommended developer workflows (CLI usage, configuration mechanisms, extension entry points).
Changes:
- Adds contextual cross-links and “start building” entry points in concepts and guides to help readers navigate to the right implementation path.
- Reworks several index pages into goal-based tables (plugin fundamentals, services, DAL/data handling) for faster onboarding.
- Clarifies tooling and project workflow guidance (Shopware CLI vs
bin/console, configuration sources, static plugins guidance) and updates some plugin authoring guidance.
Reviewed changes
Copilot reviewed 21 out of 21 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| products/tools/cli/index.md | Adds a pointer to CI/CD and dev-environment examples in the CLI installation page. |
| guides/plugins/themes/styling/override-bootstrap-variables-in-a-theme.md | Adds a conceptual link explaining Bootstrap usage in the Storefront. |
| guides/plugins/themes/index.md | Fixes formatting and adds Storefront Concept context for Bootstrap-based themes. |
| guides/plugins/plugins/services/index.md | Replaces a bullet list with a goal-based “start here” table for services docs. |
| guides/plugins/plugins/services/adjusting-service.md | Adds conceptual framing for when to use events vs service decoration and why abstract contracts are used. |
| guides/plugins/plugins/plugin-fundamentals/use-plugin-configuration.md | Expands intro and refines prerequisites list wording. |
| guides/plugins/plugins/plugin-fundamentals/index.md | Replaces narrative bullets with goal-based navigation tables and a recommended learning path. |
| guides/plugins/plugins/plugin-fundamentals/add-plugin-configuration.md | Adds a small “start simple” hint to the config.xml setup. |
| guides/plugins/plugins/index.md | Adds guidance on when to prefer static plugins vs managed plugins vs bundles. |
| guides/plugins/plugins/framework/data-handling/index.md | Replaces PageRef links with a goal-based table for DAL topics. |
| guides/plugins/plugins/framework/data-handling/add-custom-complex-data.md | Adds an extra prerequisite framing sentence for custom DAL entities. |
| guides/plugins/plugins/dependencies/using-composer-dependencies.md | Adds an overview explaining dependency installation differences by plugin setup; adjusts wording in the example section. |
| guides/plugins/plugins/database/database-migrations.md | Removes the section about customizing migration namespace/path. |
| guides/plugins/plugins/creating-plugins.md | Updates example Shopware core requirement and adds guidance on depending on other plugins; updates Packagist auth reference. |
| guides/plugins/plugins/administration/index.md | Adds a pointer to Meteor Admin SDK for stable extension points. |
| guides/installation/project-overview.md | Reframes project tooling around Shopware CLI workflows (project dev, project console, swx). |
| guides/hosting/configurations/shopware/index.md | Adds a new overview section explaining configuration mechanisms and precedence. |
| guides/development/tooling/index.md | Adds a decision guide for which CLI/tool to use and when (raw vs helper vs deployment tooling). |
| guides/development/integrations-api/index.md | Clarifies Admin API Sync API phrasing for bulk write use cases. |
| concepts/extensions/index.md | Improves “start building” pathways and links to the extension development guide and base guides. |
| concepts/api/index.md | Adds a “start building” pointer to the practical APIs guide. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| } | ||
| ``` | ||
|
|
||
| Shopware will then enforce that the required plugin is installed and activated first. For version constraints, dev setups, and store considerations, see [Add Plugin Dependencies](./dependencies/add-plugin-dependencies.md). |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A set of small fixes based on conversations within the DX Tools team from Feb 2026. No deleted pages or moves,.
Related links
Checklist
PageRefreferences where relevant..gitbook.yamlif pages were moved, renamed, or deleted..wordlist.txt(and sorted it) if spellcheck flags new legitimate terms.Notes