Handle Original Documentation Pages
After moving content to the new documentation location, it is important to properly handle the original (old) documentation pages. This ensures that:
- old links still work for users,
- no duplicate content remains,
- pages on Extensions continue to provide technical information.
When Moving Part of a Page
When you move one or more sections:
- Do not remove the old section entirely. Keep the title of the section (i.e., the heading), and use the section to point to the new page/s.
- If you want to rename a section or remove its title, insert an "id name" with the old name of the section (e.g.,
{{id name="HSectionName"/}}). This way, users that have the old link saved can still reach the information they are interested in by finding their way to the new URL. - You can use the redirect syntax to link the new page from the old page.
When the Page No Longer Contains Documentation Content
This section applies when a page no longer contains documentation content, either because the documentation was moved to a new location, or because the page is an extension page newly imported and only contains technical information such as dependencies or prerequisites.
- If the page is from "/Documentation", you just need to replace existing backlinks with links to the new pages.
- If the page is from the Extension sub-wiki and represents an extension page, do not remove it, as it still contains other technical information (e.g., dependencies, prerequisites). Instead, make sure to correctly handle Extensions.XWiki.org pages when you are migrating and refactoring and to replace existing backlinks with links to the new pages.
Replace Existing Backlinks with Links to the New Pages
After moving the entire page, whether from the main wiki or the Extensions sub-wiki, it is important to check the backlinks of the original page. For each documentation page that appears in the "Backlinks" of the original page, update the corresponding link or links so that they point to the new documentation page location. This ensures that users are directed to the updated content.
