Ubuntu Wiki:Migration

All pages from the old Ubuntu wikis are archived on GitHub.

What if I don't have create page rights?

Most new editors of the wiki require at least 10 edits, where the first edit is 4 or more days old before they can create new pages. If this is blocking you from migrating content to this wiki, you can request for a page to be created so you can edit it.

Steps to migrate an old page to the new wiki

To migrate a page to this wiki, follow the steps below:

1. Check that the contents of the page cannot already be found in this wiki or the official documentation
2. Use the search function in the GitHub repo to find the page that interests you
3. On the wiki, search for the page name that you want to use on the wiki
4. If the page doesn't exist, you will be prompted to create it
5. Copy the source from the GitHub repo and paste it into the new page
6. Fix any syntax or rendering issues in the text that you pasted
7. Save the page

Tips when migrating to the new wiki

Migrations should not be done mechanically or in bulk. Identify priority pages to migrate and then try to improve them when migrating.

• During the archiving, MoinMoin syntax was converted to MediaWiki syntax. This may have introduced errors in syntax. The nowiki tags around links need to be removed. Some pages that relied on the transclusion of content from other pages may be effectively empty. Use your judgement: fix any issues and preview the page before saving. If a page is empty, you may need to find other pages that it pulled from.
• Old wiki pages may be poorly named and migrating can be a good opportunity to give them a better name. Create a page with the new, improved name. Once it's saved, create a page using the old name (if it's available) and redirect it to the new page.
• Old wiki pages may contain errors and outdated content. See if you can fix any of these issues or leave a note for other editors saying that the page was migrated and may need to be reviewed and updated.

"I have pages on the old wiki and I don't know where to put them yet"

If you are worried about users/readers/applicants losing access to a page on the old wiki, but don't know yet if it's a good fit for the new wiki, go to Ubuntu Wiki:Migration/Temporary and follow the instructions.

Migrating pages from the wiki to the official docs

If a page is a candidate for the official Ubuntu documentation, or duplicates content found in the documentation, tag the pages by adding one of the following two templates at the top:

• Template:Doccan - documentation candidate
• Template:Docdup - documentation duplicate

Then open a discussion on the relevant page explaining why the page should be migrated or modified.

If a page is being migrated, a redirect should not be set up that goes directly to an external site. At a minimum, a short overview of the topic should be written on the wiki to provide context for the link to the external website.

For example, if ubuntu.com/foo/docs/install contains the authoritative documentation on installing foo, it doesn't mean the wiki cannot contain a brief explanation of foo that links to the installation documentation. If foo can be installed in five different ways, but the docs only account for the official method, then the wiki could include a broader installation guide that links out for the official method alone.