Jump to: navigation, search

Difference between revisions of "How To Use The Wiki"

m
Line 10: Line 10:
  
 
This wiki is made with [https://www.mediawiki.org/wiki/MediaWiki MediaWiki technology] and uses the MediaWiki syntax and markup, learn more at http://www.mediawiki.org/wiki/Help:Formatting.
 
This wiki is made with [https://www.mediawiki.org/wiki/MediaWiki 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 [https://wiki.openstack.org/wiki/Category:home:Wiki 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 ===
 +
 +
//
 +
 +
== 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 [[Special:AncientPages|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.
 +
 +
<nowiki>{{ImplementedFeature}}</nowiki>
 +
{{ImplementedFeature}}
 +
 +
<nowiki>{{OldDesignPage}}</nowiki>
 +
{{OldDesignPage}}
 +
 +
===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 [https://wiki.openstack.org/w/index.php?title=Special%3AAllPages&from=&to=&namespace=110 here]
 +
 +
  
 
[[category:contribute]]
 
[[category:contribute]]

Revision as of 09:30, 10 October 2014

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.

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

//

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 2014-10-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 2014-10-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