Re: [openstack-dev] [all] A more dynamic wiki, introducing Categories
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
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
[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
Re: [openstack-dev] [all] A more dynamic wiki, introducing Categories
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
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
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
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
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