How To Use The Wiki
We're using this wiki as a place to store and discuss requirements, architectural decisions, archive information from meetings and notify about meetings, as well as provide installation, configuration, and getting started documentation for OpenStack deployers.
How to create a new wiki page
See the MediaWiki Help Contents for documentation on how to use a MediaWiki. For OpenStack wiki, consider always adding a Category to the page, following the taxonomy described below.
Wiki Technology Documentation
OpenStack is innovating so quickly that despite our best efforts, outdated content appears on this wiki. This article outlines some ways you can assist in keeping our wiki clean.
To make the 350+ pages of the wiki more easily navigable a Taxonomy has been put into place. Adding a taxonomy and templates (coming soon) can help newcomers discover relevant content and find information more easily on the wiki.
How to use the Wiki Taxonomy
In this taxonomy, the OpenStack Wiki is divided into 5 main categories: Connect, Contribute, Programs, Releases, Resources. You can see the full tree on the special page Category:Home
Various wiki pages are linked, and made dependent of, these main categories. When creating a new page on the wiki you can check the taxonomy to see where your page fits in exactly, and make it more easy to find.
To link a page under a category just add this text to the bottom of the page: [[Category:CategoryX]]
Replace "CategoryX" with the name of the category you are linking to.
Finding Old Pages
MediaWiki has some helpful tools for finding pages that need attention.
Under "Special Pages" in the "Toolbox" menu, you can find many maintenance reports, including a list of the Oldest Pages
Simply work through the list of your choice, fixing as you go :)
Old Design Pages
The wiki is often used for fleshing out the designs of features, which usually start their life as Launchpad Blueprints. These early prototype designs are very useful during implementation, but can become out of date shortly after release when the next development cycle starts. To assist with this, we have two templates to use. Simply include the code at the top of a wiki page to add the banner.
| Old Design Page
This page was used to help design a feature that has been implemented. As a result, this page is unlikely to be updated and could contain outdated information. It was last updated on 2016-06-10
Really Quite Obsolete Pages
In general, if you see an obsolete page, it's best to attempt to improve it. However, there are some pages that for various reasons (eg they are so out of date that they are beyond fixing and their being in search results is causing mass confusion) should be strongly marked as such.
For this, we have the Obsolete namespace.
To move pages to this graveyard, on the top menu click "Actions", "Move", then select the "Obsolete" namespace on the following form.
The "move" command on the wiki is available to all users (not just admins, like delete is), and it's easier to restore bad moves than page deletes.
Though, just because a page is old, doesn't necessarily mean it should be moved out - sometimes we need to refer to old blueprint plans to see the history, and it's nice to look back at what went on at the Austin summit, so use sparingly.
You can see a list of pages in the Obsolete namespace here