Skip to content

chore: updates from Feb 2026 DX Tools mtg notes#2380

Open
somethings (lasomethingsomething) wants to merge 17 commits into
mainfrom
docs-adds-jul
Open

chore: updates from Feb 2026 DX Tools mtg notes#2380
somethings (lasomethingsomething) wants to merge 17 commits into
mainfrom
docs-adds-jul

Conversation

@lasomethingsomething

@lasomethingsomething somethings (lasomethingsomething) commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

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

  • 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

Copilot AI review requested due to automatic review settings July 16, 2026 11:59
@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Jul 16, 2026

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: d967e09
Preview: https://developer-documentation-pqcp0lass-shopware-frontends.vercel.app
Workflow run: #4502

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread guides/plugins/plugins/framework/data-handling/index.md Outdated
Comment thread guides/plugins/plugins/framework/data-handling/add-custom-complex-data.md Outdated
Comment thread guides/plugins/plugins/dependencies/using-composer-dependencies.md Outdated
}
```

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).
Comment thread guides/hosting/configurations/shopware/index.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

DX Team #product-cc-dx-tools

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants