chore: adds last changes from earlier mega-PR

[somethings (lasomethingsomething)]

Summary

This PR closes out changes in #2132. Changes include:

• fixes broken links in a recent JIRA filed by the docs team
• rearranges the plugins section
• fixes other broken links, typos, double spaces, and issues
• updates the gitbook with redirects
• no spelling issues came up during a check

Related links

#2132

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

[github-actions]

⚠️ Moved markdown files detected. Please ensure redirects are updated in .gitbook.yaml file.

[Copilot]

Pull request overview

This PR consolidates a large set of documentation changes originally tracked in #2132, primarily focusing on link fixes, navigation/section restructuring (notably Plugins/Themes), and adding/adjusting redirects for moved/renamed pages.

Changes:

• Updated many internal links and moved/reshaped documentation sections (especially Plugins/Themes and related references).
• Added new index/overview pages and new guides (e.g., theme styling/inheritance, plugin creation/install, legacy installation migration).
• Expanded .gitbook.yaml redirects to preserve old URLs after page moves/renames.

Reviewed changes

Copilot reviewed 227 out of 228 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
resources/references/security.md	Fixes link target for Flags reference.
resources/references/index.md	Rewrites References landing page content/structure.
resources/guidelines/troubleshooting/index.md	Removes legacy troubleshooting index page.
products/paas/shopware-paas/repository.md	Updates install/migration links and list formatting.
products/digital-sales-rooms/index.md	Updates devenv link path.
products/cli/shopware-account-commands/authentication.md	Improves wording/flow for authentication instructions.
products/cli/project-commands/remote-extension-management.md	Adjusts title casing and updates Fixture Bundle link.
products/cli/project-commands/mysql-dump.md	Updates title casing.
products/cli/project-commands/autofix.md	Adjusts heading casing and fixes extension-management link.
products/cli/extension-commands/build.md	Updates title casing and minor wording/punctuation.
index.md	Updates “installation guide” link on home page.
guides/upgrades-migrations/language-pack-migration.md	Fixes relative reference link.
guides/upgrades-migrations/extension-translation.md	Fixes relative links to concepts pages.
guides/plugins/themes/theme-base-guide.md	Replaces intro with workflow-oriented steps; fixes links.
guides/plugins/themes/styling/override-theme-breakpoints.md	Adds new guide for overriding breakpoints in themes.
guides/plugins/themes/styling/override-bootstrap-variables-in-a-theme.md	Fixes intra-theme links to new structure.
guides/plugins/themes/styling/index.md	Adds new theme styling index page.
guides/plugins/themes/styling/add-css-js-to-theme.md	Fixes links to new theme guide paths.
guides/plugins/themes/inheritance/index.md	Adds new theme inheritance index page.
guides/plugins/themes/inheritance/add-theme-inheritance.md	Fixes links to new theme guide paths.
guides/plugins/themes/inheritance/add-theme-inheritance-without-resources.md	Fixes links to new theme guide paths; minor wording.
guides/plugins/themes/index.md	Reworks Themes landing page into “Storefront Themes” + comparisons.
guides/plugins/themes/differences-plugins-and-apps-vs-themes.md	Removes old “differences” page (content merged elsewhere).
guides/plugins/themes/create-a-theme.md	Reworks “Create a theme” guide structure and troubleshooting.
guides/plugins/themes/configuration/theme-inheritance-configuration.md	Fixes links to new inheritance paths.
guides/plugins/themes/configuration/theme-configuration.md	Fixes PageRef path and multiple guide links.
guides/plugins/themes/configuration/index.md	Adds new theme configuration index page.
guides/plugins/themes/assets/index.md	Adds new theme assets index page.
guides/plugins/themes/assets/add-icons.md	Fixes links and removes stray backtick line.
guides/plugins/themes/assets/add-assets-to-theme.md	Fixes PageRef and cross-links to new structure.
guides/plugins/plugins/storefront/templates/twig-function-reference.md	Renames page/title and updates theme_config link.
guides/plugins/plugins/storefront/templates/index.md	Updates list item casing and reference label.
guides/plugins/plugins/storefront/templates/customize-templates.md	Rewrites prerequisites as bullet list.
guides/plugins/plugins/storefront/templates/customize-header-footer.md	Adds “Overview” section.
guides/plugins/plugins/storefront/templates/add-custom-twig-function.md	Adds “Overview” section.
guides/plugins/plugins/storefront/styling/add-translations.md	Adds “Overview” section.
guides/plugins/plugins/storefront/styling/add-scss-variables.md	Adds “Overview” section.
guides/plugins/plugins/storefront/styling/add-scss-variables-via-subscriber.md	Adds “Overview” section.
guides/plugins/plugins/storefront/styling/add-icons.md	Adds “Overview” and adjusts theme wording/linking.
guides/plugins/plugins/storefront/styling/add-custom-styling.md	Adds “Overview” and fixes theme link path.
guides/plugins/plugins/storefront/styling/add-custom-assets.md	Adds “Overview” and updates PageRef path.
guides/plugins/plugins/storefront/javascript/plugin-reference.md	Renames title and adds “Overview”.
guides/plugins/plugins/storefront/javascript/override-existing-javascript.md	Adds “Overview” section.
guides/plugins/plugins/storefront/javascript/index.md	Title-cases list items and reference label.
guides/plugins/plugins/storefront/javascript/fetching-data-with-javascript.md	Adds “Overview” section.
guides/plugins/plugins/storefront/javascript/add-javascript-as-script-tag.md	Adds “Overview” and title-cases nav/title.
guides/plugins/plugins/storefront/javascript/add-custom-javascript.md	Adds “Overview” section.
guides/plugins/plugins/storefront/index.md	Major rewrite: workflow + section structure + link list.
guides/plugins/plugins/storefront/howto/using-the-datepicker-plugin.md	Adds “Overview” section.
guides/plugins/plugins/storefront/howto/using-custom-fields-storefront.md	Adds “Overview” section.
guides/plugins/plugins/storefront/howto/using-a-modal-window.md	Adds “Overview” section.
guides/plugins/plugins/storefront/howto/use-nested-line-items.md	Adds “Overview” section.
guides/plugins/plugins/storefront/howto/use-media-thumbnails.md	Adds “Overview” section.
guides/plugins/plugins/storefront/howto/add-listing-filters.md	Adds “Overview” and fixes spacing/formatting.
guides/plugins/plugins/storefront/howto/add-custom-sorting-product-listing.md	Adds “Overview” section.
guides/plugins/plugins/storefront/howto/add-custom-captcha.md	Adds “Overview” section.
guides/plugins/plugins/storefront/controllers/index.md	Compresses intro into a single paragraph.
guides/plugins/plugins/storefront/controllers/add-dynamic-content-via-ajax-calls.md	Adds “Overview” section.
guides/plugins/plugins/storefront/controllers/add-data-to-storefront-page.md	Adds “Overview” section.
guides/plugins/plugins/storefront/controllers/add-custom-pagelet.md	Adds “Overview” section.
guides/plugins/plugins/storefront/controllers/add-custom-page.md	Adds “Overview” section.
guides/plugins/plugins/storefront/controllers/add-custom-controller.md	Adds “Overview” section.
guides/plugins/plugins/storefront/advanced/index.md	Renames nav title and fixes “JavaScript” casing in list item.
guides/plugins/plugins/services/dependency-injection.md	Title-cases nav title.
guides/plugins/plugins/services/adjusting-service.md	Title-cases nav title.
guides/plugins/plugins/services/add-custom-service.md	Adds “Overview” section.
guides/plugins/plugins/plugin-fundamentals/use-plugin-configuration.md	Adjusts nav position.
guides/plugins/plugins/plugin-fundamentals/plugin-lifecycle.md	Major rewrite/restructure + adds “Overview”; updates examples.
guides/plugins/plugins/plugin-fundamentals/logging.md	Adds front matter/nav metadata.
guides/plugins/plugins/plugin-fundamentals/add-scheduled-task.md	Title-cases nav title and removes empty overview heading.
guides/plugins/plugins/plugin-fundamentals/add-plugin-configuration.md	Improves wording/structure; adds collapsible types table.
guides/plugins/plugins/plugin-fundamentals/add-custom-commands.md	Title-cases nav title and updates section heading.
guides/plugins/plugins/plugin-base-guide.md	Replaces long tutorial with higher-level flow + links.
guides/plugins/plugins/integrations/index.md	Adds new Integrations landing page.
guides/plugins/plugins/integrations/elasticsearch/add-product-entity-extension-to-elasticsearch.md	Title-cases nav title.
guides/plugins/plugins/integrations/commercial/multi-inventory.md	Adds Overview section.
guides/plugins/plugins/integrations/commercial/index.md	Reorders list items.
guides/plugins/plugins/integrations/commercial/customer-specific-pricing.md	Adjusts heading casing and adds Overview.
guides/plugins/plugins/install-activate-plugin.md	Adds new guide for installing/activating plugins.
guides/plugins/plugins/index.md	Rewrites Plugins landing page, adds guidance and comparison.
guides/plugins/plugins/framework/system-check/add-custom-check.md	Fixes headings and adds Overview section.
guides/plugins/plugins/framework/store-api/override-existing-route.md	Title-cases nav title.
guides/plugins/plugins/framework/store-api/index.md	Expands Store API guidance with principles and next steps.
guides/plugins/plugins/framework/rule/add-custom-rules.md	Rewrites intro text.
guides/plugins/plugins/framework/rate-limiter/add-rate-limiter-to-api-route.md	Adds rate limiter definition paragraph.
guides/plugins/plugins/framework/message-queue/add-middleware.md	Title-cases nav title.
guides/plugins/plugins/framework/message-queue/add-message-to-queue.md	Title-cases and fixes heading.
guides/plugins/plugins/framework/message-queue/add-message-handler.md	Title-cases and fixes heading.
guides/plugins/plugins/framework/index.md	Expands section intro and adds list of subtopics.
guides/plugins/plugins/framework/flow/add-flow-builder-trigger.md	Title-cases headings and updates Flow reference link.
guides/plugins/plugins/framework/flow/add-flow-builder-action.md	Updates Flow reference link.
guides/plugins/plugins/framework/flow/action-transactions.md	Title-cases headings.
guides/plugins/plugins/framework/filesystem/index.md	Rewrites Filesystem intro.
guides/plugins/plugins/framework/filesystem/filesystem.md	Reorders prerequisites section.
guides/plugins/plugins/framework/event/listening-to-events.md	Adds “Overview” section.
guides/plugins/plugins/framework/data-handling/writing-data.md	Adds “Overview” section.
guides/plugins/plugins/framework/data-handling/versioning-entities.md	Adds “Overview” section.
guides/plugins/plugins/framework/data-handling/using-flags.md	Adds “Overview” and updates Flags reference link.
guides/plugins/plugins/framework/data-handling/using-database-events.md	Adds “Overview” section.
guides/plugins/plugins/framework/data-handling/reading-data.md	Adds “Overview” and updates DAL reference links.
guides/plugins/plugins/framework/data-handling/entities-via-attributes.md	Adds “Overview” section.
guides/plugins/plugins/framework/data-handling/add-data-indexer.md	Reflows intro paragraphs.
guides/plugins/plugins/framework/caching/index.md	Adds “Overview” section.
guides/plugins/plugins/dependencies/using-npm-dependencies.md	Title-cases nav title.
guides/plugins/plugins/dependencies/using-composer-dependencies.md	Title-cases nav title and adds Overview.
guides/plugins/plugins/dependencies/add-plugin-dependencies.md	Adds Overview and rewrites intro.
guides/plugins/plugins/database/database-migrations.md	Adds “Overview” section.
guides/plugins/plugins/database/custom-fields-of-type-media.md	Title-cases nav title and adds Overview.
guides/plugins/plugins/creating-plugins.md	Adds new guide for plugin creation/scaffolding.
guides/plugins/plugins/content/sitemap/remove-sitemap-entries.md	Title-cases nav title and adds Overview.
guides/plugins/plugins/content/sitemap/add-custom-sitemap-entries.md	Fixes DI link and replaces adjusting-services reference with inline link.
guides/plugins/plugins/content/media/remote-thumbnail-generation.md	Adds “Overview” section.
guides/plugins/plugins/content/media/add-custom-file-extension.md	Adds “Overview” section.
guides/plugins/plugins/content/cms/add-data-to-cms-elements.md	Title-cases and adds Overview.
guides/plugins/plugins/content/cms/add-cms-element.md	Renames headings and fixes spacing.
guides/plugins/plugins/content/cms/add-cms-block.md	Renames headings and fixes spacing.
guides/plugins/plugins/checkout/cart/customize-price-calculation.md	Adds “Overview” section.
guides/plugins/plugins/checkout/cart/add-cart-processor-collector.md	Title-cases nav title.
guides/plugins/plugins/bundle.md	Updates links and wording; adjusts headings/casing.
guides/plugins/plugins/administration/templates-styling/adding-responsive-behavior.md	Title-cases headings and adds Overview.
guides/plugins/plugins/administration/templates-styling/add-custom-styles.md	Title-cases headings.
guides/plugins/plugins/administration/services-utilities/using-utils.md	Adds Overview and fixes shortcuts link path.
guides/plugins/plugins/administration/services-utilities/using-filter.md	Title-cases headings and rewrites sentence.
guides/plugins/plugins/administration/services-utilities/the-sanitizer-helper.md	Adds front matter and standardizes heading.
guides/plugins/plugins/administration/services-utilities/making-api-requests.md	Title-cases nav title.
guides/plugins/plugins/administration/services-utilities/injecting-services.md	Adds front matter and rewrites overview.
guides/plugins/plugins/administration/services-utilities/extending-services.md	Title-cases headings and clarifies links.
guides/plugins/plugins/administration/services-utilities/add-filter.md	Title-cases headings and rewrites intro.
guides/plugins/plugins/administration/routing-navigation/overriding-routes.md	Title-cases headings.
guides/plugins/plugins/administration/routing-navigation/add-new-tab.md	Title-cases headings and rewrites intro.
guides/plugins/plugins/administration/routing-navigation/add-menu-entry.md	Title-cases headings.
guides/plugins/plugins/administration/routing-navigation/add-custom-route.md	Title-cases headings and adds Overview.
guides/plugins/plugins/administration/permissions-error-handling/add-error-handling.md	Fixes heading formatting.
guides/plugins/plugins/administration/permissions-error-handling/add-acl-rules.md	Title-cases headings.
guides/plugins/plugins/administration/module-component-management/using-base-components.md	Title-cases headings and adds Overview.
guides/plugins/plugins/administration/module-component-management/index.md	Reorders list items.
guides/plugins/plugins/administration/module-component-management/customizing-modules.md	Title-cases headings.
guides/plugins/plugins/administration/module-component-management/customizing-components.md	Title-cases headings and adds Overview.
guides/plugins/plugins/administration/module-component-management/add-custom-module.md	Title-cases headings and adds Overview.
guides/plugins/plugins/administration/module-component-management/add-custom-field.md	Title-cases headings and rewrites intro.
guides/plugins/plugins/administration/module-component-management/add-custom-component.md	Renames title to plural form.
guides/plugins/plugins/administration/mixins-directives/using-mixins.md	Rewrites intro and fixes links.
guides/plugins/plugins/administration/data-handling-processing/using-vuex-state.md	Adds front matter/nav metadata.
guides/plugins/plugins/administration/data-handling-processing/using-the-data-grid-component.md	Title-cases headings.
guides/plugins/plugins/administration/data-handling-processing/using-data-handling.md	Title-cases headings and adds Overview.
guides/plugins/plugins/administration/data-handling-processing/using-custom-fields.md	Title-cases headings.
guides/plugins/plugins/administration/data-handling-processing/the-shopware-object.md	Title-cases headings.
guides/plugins/plugins/administration/data-handling-processing/search-custom-data.md	Title-cases headings.
guides/plugins/plugins/administration/data-handling-processing/handling-media.md	Adds front matter/nav metadata and title-cases heading.
guides/plugins/plugins/administration/advanced-configuration/modify-blacklist-for-dynamic-product-groups.md	Title-cases heading.
guides/plugins/plugins/administration/advanced-configuration/add-shortcuts.md	Title-cases nav title.
guides/plugins/plugins/administration/advanced-configuration/add-rule-assignment-configuration.md	Title-cases headings.
guides/plugins/plugins/administration/administration-reference/utils.md	Renames to “Utils Reference”.
guides/plugins/plugins/administration/administration-reference/mixins.md	Renames to “Mixins Reference”.
guides/plugins/plugins/administration/administration-reference/directives.md	Renames to “Directives Reference”.
guides/plugins/apps/storefront/customize-templates.md	Title-cases nav title.
guides/plugins/apps/storefront/cookies-with-apps.md	Adds Overview section.
guides/plugins/apps/storefront/apps-as-themes.md	Title-cases and updates theme.json link.
guides/plugins/apps/rule-builder/add-custom-rule-conditions.md	Adds Overview section.
guides/plugins/apps/lifecycle/webhook.md	Adds Overview and fixes spacing in text.
guides/plugins/apps/lifecycle/product-translator.md	Reworks headings and adds Overview.
guides/plugins/apps/lifecycle/configuration.md	Adds Overview section.
guides/plugins/apps/lifecycle/clientside-to-app-backend.md	Adds Overview section.
guides/plugins/apps/lifecycle/app-signature-verification.md	Adds Overview section.
guides/plugins/apps/lifecycle/app-registration-setup.md	Adds Overview section.
guides/plugins/apps/gateways/in-app-purchase/in-app-purchase-gateway.md	Adds Overview and wording fixes.
guides/plugins/apps/flow-builder/add-custom-flow-triggers-from-app-system.md	Adds Overview section.
guides/plugins/apps/flow-builder/add-custom-flow-actions-from-app-system.md	Adds Overview section.
guides/plugins/apps/custom-data/custom-fields.md	Renames headings and adds Overview.
guides/plugins/apps/custom-data/custom-entities.md	Renames headings and adds Overview.
guides/plugins/apps/create-admin-extension.md	Adds Overview section.
guides/plugins/apps/content/cms/index.md	Minor formatting (trailing newline).
guides/plugins/apps/content/cms/add-custom-cms-blocks.md	Adds Overview section and rewrites intro.
guides/plugins/apps/checkout/tax-provider.md	Adds Overview section.
guides/plugins/apps/checkout/shipping-methods.md	Adds Overview section.
guides/plugins/apps/checkout/payment.md	Adds Overview section.
guides/plugins/apps/app-sdks/symfony-bundle/index.md	Renames/clarifies bundle page title.
guides/plugins/apps/app-sdks/index.md	Adds SDK comparison table.
guides/plugins/apps/app-scripts/data-loading.md	Adds Overview section.
guides/plugins/apps/app-scripts/custom-endpoints.md	Adds Overview and rewrites intro.
guides/plugins/apps/app-scripts/cart-manipulation.md	Adds Overview section.
guides/plugins/apps/app-scripts/add-api-endpoint.md	Reworks heading and adds Overview.
guides/plugins/apps/app-base-guide.md	Adds Overview section.
guides/plugins/apps/administration/add-custom-modules.md	Adds Overview and minor wording fix.
guides/plugins/apps/administration/add-custom-action-button.md	Adds Overview and rewrites intro.
guides/plugins/apps/administration/add-cms-element-via-admin-sdk.md	Adds Overview section.
guides/installation/legacy-setups/migrate-zip-to-composer-project.md	Adds new legacy migration guide.
guides/installation/legacy-setups/devenv-setup.md	Adjusts list formatting.
guides/hosting/performance/performance.md	Renames page/nav title to “Troubleshooting”.
guides/hosting/performance/lock-store.md	Renames heading to “Lock Storage”.
guides/hosting/installation-updates/performing-updates.md	Fixes System Requirements link.
guides/hosting/installation-updates/deployments/index.md	Links “CI” to CI guide.
guides/hosting/installation-updates/deployments/deployment-with-deployer.md	Fixes Symfony Flex template link target.
guides/hosting/installation-updates/deployments/build-w-o-db.md	Title-cases headings.
guides/hosting/infrastructure/scheduled-task.md	Adjusts nav position and fixes heading capitalization.
guides/hosting/infrastructure/reverse-http-cache.md	Adjusts nav position.
guides/hosting/infrastructure/redis.md	Adjusts nav position.
guides/hosting/infrastructure/rate-limiter.md	Adjusts nav position.
guides/hosting/infrastructure/optional-packages.md	Adds new “Optional Packages” page.
guides/hosting/infrastructure/message-queue.md	Adjusts nav position and wording tweaks.
guides/hosting/infrastructure/index.md	Adjusts nav position.
guides/hosting/infrastructure/filesystem.md	Adjusts nav position.
guides/hosting/infrastructure/elasticsearch/index.md	Fixes nav position spacing and adds external link.
guides/hosting/infrastructure/elasticsearch/elasticsearch.md	Adds intro + error handling adjustments and headings.
guides/hosting/infrastructure/elasticsearch/elasticsearch-setup.md	Updates troubleshooting link target.
guides/hosting/infrastructure/elasticsearch/elasticsearch-debugging.md	Renames to “Debugging and Troubleshooting…” and wording fixes.
guides/development/troubleshooting/rules-reference.md	Adjusts nav position.
guides/development/troubleshooting/phpstan.md	Rewrites headings and intro text.
guides/development/troubleshooting/dal-reference/index.md	Expands DAL reference landing page content.
guides/development/troubleshooting/dal-reference/fields-reference/enum-field.md	Title-cases headings and minor spacing fix.
guides/development/testing/unit/php-unit.md	Fixes flex template link target.
guides/development/testing/unit/jest-storefront.md	Title-cases nav title.
guides/development/testing/unit/jest-admin.md	Title-cases nav title.
guides/development/testing/testing-guidelines.md	Title-cases nav title.
guides/development/testing/ci.md	Renames to “Continuous Integration” and updates intro.
guides/development/monetization/index.md	Fixes link path to store-review-errors.
guides/development/extensions/index.md	Minor wording improvements.
guides/development/extensions/code-structure.md	Updates extension type guidance and wording.
guides/development/extensions/architecture/internal.md	Adds Overview section.
guides/development/extensions/architecture/index.md	Adds Overview section.
guides/development/extensions/architecture/final-and-internal.md	Adds Overview section.
guides/development/extensions/architecture/extendability.md	Adds Overview section.
guides/development/accessibility/storefront-accessibility.md	Minor wording + list indentation fixes.
concepts/translations/fallback-language-selection.md	Updates links to migration guides.
concepts/translations/built-in-translation-system.md	Replaces reference links with updated migration guide link.
concepts/framework/elasticsearch.md	Fixes link to elasticsearch extension guide.
concepts/framework/data-abstraction-layer.md	Fixes relative path to ERD PDF.
.gitbook.yaml	Adds/adjusts redirects for moved/renamed pages.

Comments suppressed due to low confidence (1)

guides/hosting/infrastructure/elasticsearch/elasticsearch.md:24

• The bullet label has broken emphasis markup (* ***Search server is not reachable**:). This renders incorrectly; it should be a normal bold label like * **Search server is not reachable**:.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[somethings (lasomethingsomething)]

Su (@sushmangupta) Fixing the conflicts right now -- do you have a new ETA for review?

UPDATE: conflicts fixed

[Su (sushmangupta)]

Su (Su (@sushmangupta)) Fixing the conflicts right now -- do you have a new ETA for review?

UPDATE: conflicts fixed

somethings (@lasomethingsomething) - Reviewing now :)