Migrate and Refactor Documentation

As of September 2025, documentation is being refactored, and moved to /documentation root. These steps describe the flow of how to migrate or reorganize existing documentation content from older locations ("Documentation" or Extensions wiki) into the /documentation root. Following them helps avoid duplicated work, content and ensures consistent structure and navigation.

1. Check for existing Change Requests. Before starting any migration work, make sure that no one else is already working on the same page or content.
2. Use the documentation resources section. It provides XAR files that you can import into your wiki to quickly set up a realistic environment, with ready-made examples for creating screenshots and documentation content.
3. Choose the Right Location. Decide where the migrated content should live inside the documentation tree.
4. Apply Diataxis. When migrating existing documentation, you may encounter pages or sections that mix multiple documentation types. Such content must be split into multiple pages, each with a single purpose and corresponding to a Diataxis type.
5. Create pages using the correct page structure.
6. Respect the versioning rules, the documentation style guidelines, the attachment rules.
7. Save the changes.
8. (Optional) Add Highlights. When applicable, add highlights to help readers quickly discover key pages or concepts.
9. Improve navigation by pinning pages in the navigation panel. Where it makes sense, pin the migrated pages in the navigation to improve discoverability.
10. Avoid duplication. Make sure the same content is not kept in both the original documentation and the new documentation pages. When content has been moved, properly handle the original documentation pages.

• If you are creating new documentation, follow the Create New Documentation- Flow Guide.
• To update existing documentation pages, follow the process described in updating existing pages.