[openstack-dev] [all] A more dynamic wiki, introducing Categories

Stefano Maffulli stefano at openstack.org
Fri Nov 14 11:01:26 UTC 2014


Hello folks

in the past months Shari and I have implemented more chunks of the
taxonomy developed for us by Katherine Cranford (a volunteer expert).
Using categories in the wiki pages can help us create dynamic pages and
keep information more visible, well organized and discoverable.

For example, we had a page listing all Teams. When someone needed to
create a new Team, someone would have to: 1) create a new page for the
team, save, 2) go to the Teams page, edit page adding a link to the new
page, save. Today instead the process looks like this:

 - Create a new page for the new team
 - Add the text [[Category: Teams]] to the rest of the text
 - save

Done. The new page will be automatically shown on
https://wiki.openstack.org/wiki/Category:Teams

Category pages are just like any other wiki page: they can have text,
images, can be edited, translated etc. And they automatically show the
pages contained in their category. As an example, see how the dynamic
page for Programs

https://wiki.openstack.org/wiki/Category:Programs

and the 'static' version look like:

https://wiki.openstack.org/wiki/Programs

I would apply to Programs the same redirect I created for Teams (unless
someone stops me).

Pages generated automatically this way are a huge improvement to
navigation inside the wiki and I suggest you all to get familiar with
the list of Categories shown in a nice tree on:

 https://wiki.openstack.org/wiki/Category:Home

and read the Taxonomy section in:

https://wiki.openstack.org/wiki/How_To_Use_The_Wiki

As this is a wiki, your help is needed: think about adding pages you
manage to an existing category and when possible consider moving
'static' pages to the newly created dynamic pages.

Cheers,
stef



More information about the OpenStack-dev mailing list