Jump to: navigation, search

How To Use The Wiki

Revision as of 16:06, 10 June 2016 by Fungi (talk | contribs) (revert spam)

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.

You can learn more about how to contribute to the OpenStack project and wiki as well as our Governance policy.

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

This wiki is made with MediaWiki technology and uses the MediaWiki syntax and markup, learn more at http://www.mediawiki.org/wiki/Help:Formatting.

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.

Wiki Taxonomy

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.

Wiki Gardening

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.

{{ImplementedFeature}}

Warning.svg 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

{{OldDesignPage}}

Warning.svg Old Design Page

This page was used to help design a feature for a previous release of OpenStack. It may or may not have 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