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

2014-11-15 Thread Stefano Maffulli
On 11/14/2014 09:11 PM, Jeremy Stanley wrote:
 Categories emerge automatically as you tag pages into them. No
 separate category creation step is required.

True although incomplete. Categories are just pages, like almost
anything in mediawiki, so if you add text [[Category: New_Category]] in
a page, you're one step closer to creating a new category. To complete
the step, you need to actually create the New_Category page, going to
http://wiki.openstack.org/wiki/Category:New_Category and follow the
steps to create a new category.

To nest categories you can add a category page to a 'parent' category
tagging it with [[Category: Parent_Category]]. For example, see the
Category:Programs page, is itself tagged as [[Category:Home]] so that
the page https://wiki.openstack.org/wiki/Category:Home shows the
categories as a navigable tree.

If you don't create the New_Category page, it will end up in the
'wantedCategories' special page:

https://wiki.openstack.org/wiki/Special:WantedCategories

Convoluted? Yes, I agree but it is what it is.  Probably it's better
though because if you have too many categories it's like having none. I
would suggest to discuss widely the taxonomy before adding/removing items.

Cheers,
stef

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


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

2014-11-15 Thread Jeremy Stanley
On 2014-11-15 16:37:50 +0100 (+0100), Stefano Maffulli wrote:
[...]
 If you don't create the New_Category page, it will end up in the
 'wantedCategories' special page:
 
 https://wiki.openstack.org/wiki/Special:WantedCategories
[...]

Oh, neat! This is a new feature. In older* versions it just
populated the categorized articles list at the category page URL but
was otherwise undecorated until you added content.

[*] no idea how long ago that was since I've been using MW for more
than a decade and haven't set up new categories for quite some years
-- 
Jeremy Stanley

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


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

2014-11-14 Thread Thierry Carrez
Stefano Maffulli wrote:
 [...]
 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).

In this precise example, I feel like the dynamic page is much less
usable than the static page, due to the deep hierarchy. On the static
version, clicking on the program name would give us the main page for
that program, while on the dynamic version, it would lead us to another
list of categories/page from which it's difficult to guess which one is
the main one. We seem to bury the useful page down layers of category
pages.

Since the canonical list of programs is maintained in the governance
repository (which should be published in a few days on its own website),
I don't think we should duplicate it manually in the wiki anyway.

My suggestion is therefore to recategorize all Category:Programs page
into Category:Teams pages, so that all teams (whether officially
recognized as a program or not) appear on the same dynamic page as far
as the wiki is concerned. If people are interested in getting the list
of official programs, they should get it from the governance repo / site
anyway.

 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

+1 -- Autogenerated list of relevant pages shall make our wiki much more
discoverable and browseable.

-- 
Thierry Carrez (ttx)

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


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

2014-11-14 Thread Stefano Maffulli
On 11/14/2014 02:50 PM, Thierry Carrez wrote:
 In this precise example, I feel like the dynamic page is much less
 usable than the static page, due to the deep hierarchy.

Got it. The current taxonomy is trying to map precisely the hierarchy of
Program-Projects-Teams therefore it keeps the Nova project under Compute.

In fact, the page of Nova https://wiki.openstack.org/wiki/Nova is
somewhat mixing aspects of the Compute program with others more related
to the project Nova and the teams. One thing I wanted to do was to
reshuffle content, too, and split larger pages. But since we're going to
move the official list of Programs outside of the wiki (thankfully) we
may need to redesign the taxonomy and keep it leaner.

I'll put more complex changes like this one on hold until the governance
site is live.

/stef

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


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

2014-11-14 Thread Jeremy Stanley
On 2014-11-14 18:57:13 +0100 (+0100), Stefano Maffulli wrote:
[...]
 I'll put more complex changes like this one on hold until the governance
 site is live.

Which, incidentally, is awaiting https://review.openstack.org/132466
plus any change to merge in the governance repository now that the
publication job is live (assuming I wasn't completely off the rails
when I wrote it).
-- 
Jeremy Stanley

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


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

2014-11-14 Thread Rochelle Grober
Thank you Stefano (and Shari and Katherine)!

I think this will help.  Is there a way to add new categories?  I expect that 
as people start using this, more categories will be requested.

And, is there a wiki page where this info is hosted?

--Rocky

-Original Message-
From: Stefano Maffulli [mailto:stef...@openstack.org] 
Sent: Friday, November 14, 2014 3:01 AM
To: OpenStack-dev@lists.openstack.org
Subject: [openstack-dev] [all] A more dynamic wiki, introducing Categories

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

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


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

2014-11-14 Thread Jeremy Stanley
On 2014-11-14 20:04:33 + (+), Rochelle Grober wrote:
[...]
 Is there a way to add new categories?  I expect that as people
 start using this, more categories will be requested.
[...]

Categories emerge automatically as you tag pages into them. No
separate category creation step is required.
-- 
Jeremy Stanley

___
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev