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 and content, and ensures consistent structure and navigation.

Current state of the migration

During this migration, sections or whole pages content from both "/Documentation" and Extension sub-wiki have already been moved to "/documentation". In their original locations, these sections have been replaced with links pointing to the newly converted pages. Over time, both the main documentation and the extensions will be fully moved under "/documentation".

Before starting any migration work, check for existing Change Requests to make sure that no one else is already working on the same page or content.

1. 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.
2. Choose the right location. Decide where the content should live inside the documentation tree.
3. Apply Diataxis.
4. Follow the documentation page structure.
5. Respect the versioning rules, the documentation style guidelines and the attachment rules.
6. Save the changes.
7. Add Highlights when the page has many child pages, to help readers discover the key ones.
8. Improve navigation by pinning the page in the navigation. Where it makes sense, pin the page in the navigation to improve discoverability.

Two steps are specific to migration:

• When applying Diataxis, existing pages or sections often mix multiple documentation types. Such content must be split into multiple pages, each with a single purpose and corresponding to a Diataxis type.
• 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.