docs: add upgrade information for Meteor components (#1661)

* docs: add upgrade information for Meteor components

* Apply suggestions from code review

Co-authored-by: Micha Hobert <[email protected]>

* docs: fix grammar and wording

* Fix sorting and add Reusability

---------

Co-authored-by: Micha Hobert <[email protected]>

.wordlist.txt

@@ -264,6 +264,8 @@ cmsService
 codebase
 codeblock
 codeblocks
+codemods
+Codemods
 codereview
 Codestyle
 colorpicker
@@ -1321,6 +1323,7 @@ RestrictDelete
 resubmittable
 rethrown
 returnUrl
+Reusability
 revalidation
 ReverseInherited
 Reviewdog

guides/plugins/plugins/administration/system-updates/meteor-components.md

@@ -0,0 +1,57 @@
+---
+nav:
+  title: Upgrading to Meteor Components
+  position: 260
+---
+
+# Future Development Roadmap: Upgrading to Meteor Components
+
+> **Note:** The information provided in this article, including timelines and specific implementations, is subject to change.
+> This document serves as a general guideline for our development direction.
+
+## Introduction
+
+With the release of Shopware 6.7, we will replace several current administration components with components from the [Meteor Component Library](https://meteor-component-library.vercel.app/).
+
+## Why Meteor Components?
+
+The Meteor Component Library is Shopware's official collection of reusable components used across multiple Shopware projects and built on the Shopware Design System.
+
+Using a shared component library offers several advantages:
+
+- **Consistent Design**: All components follow the Shopware Design System guidelines.
+- **Consistent Behavior**: All components share standardized behavior patterns and API conventions.
+- **Reusability**: Components can be seamlessly integrated across different projects and apps.
+- **Maintenance**: Updates and improvements to components are managed centrally and automatically propagate to all projects using the component library.
+
+## Migration guide
+
+For each component being replaced, we provide a detailed upgrade guide that explains the migration process from the old component to the new Meteor Component. You can find these guides in the technical upgrade documentation for the release.
+
+## Using Codemods for migration
+
+To simplify the plugin migration process, we provide codemods that automatically replace old components with new Meteor Components.
+
+### Prerequisites
+
+- A [development installation of Shopware](https://github.com/shopware/shopware) must be installed
+- Your plugin must be located in the `custom/plugins` folder
+
+### Running the Migration Tool
+
+1. Execute the following composer command:
+
+   ```bash
+   # Main command which also outputs the help text
+   composer run admin:code-mods
+
+   ## Example with arguments
+   # composer run admin:code-mods -- --plugin-name example-plugin --fix -v 6.7
+   ```
+
+2. Provide your plugin name and target Shopware version for migration
+3. The tool will:
+   - Automatically replace compatible components with Meteor Components
+   - Add guidance comments for components that require manual migration
+   - Fixes some other deprecated code where possible
+