Hey,
I've categorized all of our SOP (Standard Operating Procedure) pages in the [[Category:Infrastructure SOPs]] and made a new page for them: https://fedoraproject.org/wiki/Category:Infrastructure_SOPs
(The old URL redirects there so old, external links are still fine). The index on the page is generated automatically by the category. This means that anytime you create a new SOP simply place this Category tag at the bottom of the page and it will appear here as well::
[[Category:Infrastructure SOPs]]
As you can see from the index on the page, the MoinMoin, hierarchical directory index scheme makes the Category Index a little ugly (everything is listed as beginning with "I" because they all start with "Infrastructure". Additionally, the docs folks recommend that everyone renames pages to be more natural language oriented so that mediawiki's search functionality works better.
If I rename in Mediawiki, there will be redirects from the old names to the new ones. Does anyone mind if I start doing that?
I was thinking of one of the following schemes:
A) Infrastructure/SOP/Baculs => Bacula B) Infrastructure/SOP/Bacula => Bacula SOP
-Toshio
Toshio Kuratomi wrote:
Hey,
I've categorized all of our SOP (Standard Operating Procedure) pages in the [[Category:Infrastructure SOPs]] and made a new page for them: https://fedoraproject.org/wiki/Category:Infrastructure_SOPs
(The old URL redirects there so old, external links are still fine). The index on the page is generated automatically by the category. This means that anytime you create a new SOP simply place this Category tag at the bottom of the page and it will appear here as well::
[[Category:Infrastructure SOPs]]
As you can see from the index on the page, the MoinMoin, hierarchical directory index scheme makes the Category Index a little ugly (everything is listed as beginning with "I" because they all start with "Infrastructure". Additionally, the docs folks recommend that everyone renames pages to be more natural language oriented so that mediawiki's search functionality works better.
If I rename in Mediawiki, there will be redirects from the old names to the new ones. Does anyone mind if I start doing that?
I was thinking of one of the following schemes:
A) Infrastructure/SOP/Baculs => Bacula B) Infrastructure/SOP/Bacula => Bacula SOP
Talked to ianweller on IRC and he recommends:
/wiki/Bacula Infrastructure SOP
and since that's a long URL... having a shortcut (basically a redirect) page name: SOP:BACULA #REDIRECT [[Bacula Infrastructure SOP]]
So http://fedoraproject.org/wiki/SOP:BACULA would take you to the proper place.
-Toshio
2009/2/14 Toshio Kuratomi a.badger@gmail.com:
Toshio Kuratomi wrote:
Hey,
I've categorized all of our SOP (Standard Operating Procedure) pages in the [[Category:Infrastructure SOPs]] and made a new page for them: https://fedoraproject.org/wiki/Category:Infrastructure_SOPs
(The old URL redirects there so old, external links are still fine). The index on the page is generated automatically by the category. This means that anytime you create a new SOP simply place this Category tag at the bottom of the page and it will appear here as well::
[[Category:Infrastructure SOPs]]
As you can see from the index on the page, the MoinMoin, hierarchical directory index scheme makes the Category Index a little ugly (everything is listed as beginning with "I" because they all start with "Infrastructure". Additionally, the docs folks recommend that everyone renames pages to be more natural language oriented so that mediawiki's search functionality works better.
If I rename in Mediawiki, there will be redirects from the old names to the new ones. Does anyone mind if I start doing that?
I was thinking of one of the following schemes:
A) Infrastructure/SOP/Baculs => Bacula B) Infrastructure/SOP/Bacula => Bacula SOP
Talked to ianweller on IRC and he recommends:
/wiki/Bacula Infrastructure SOP
and since that's a long URL... having a shortcut (basically a redirect) page name: SOP:BACULA #REDIRECT [[Bacula Infrastructure SOP]]
So http://fedoraproject.org/wiki/SOP:BACULA would take you to the proper place.
Excellent, +1
On Fri, 13 Feb 2009, Toshio Kuratomi wrote:
Toshio Kuratomi wrote:
Hey,
I've categorized all of our SOP (Standard Operating Procedure) pages in the [[Category:Infrastructure SOPs]] and made a new page for them: https://fedoraproject.org/wiki/Category:Infrastructure_SOPs
(The old URL redirects there so old, external links are still fine). The index on the page is generated automatically by the category. This means that anytime you create a new SOP simply place this Category tag at the bottom of the page and it will appear here as well::
[[Category:Infrastructure SOPs]]
As you can see from the index on the page, the MoinMoin, hierarchical directory index scheme makes the Category Index a little ugly (everything is listed as beginning with "I" because they all start with "Infrastructure". Additionally, the docs folks recommend that everyone renames pages to be more natural language oriented so that mediawiki's search functionality works better.
If I rename in Mediawiki, there will be redirects from the old names to the new ones. Does anyone mind if I start doing that?
I was thinking of one of the following schemes:
A) Infrastructure/SOP/Baculs => Bacula B) Infrastructure/SOP/Bacula => Bacula SOP
Talked to ianweller on IRC and he recommends:
/wiki/Bacula Infrastructure SOP
and since that's a long URL... having a shortcut (basically a redirect) page name: SOP:BACULA #REDIRECT [[Bacula Infrastructure SOP]]
So http://fedoraproject.org/wiki/SOP:BACULA would take you to the proper place.
My only concern here is we're not the only group with SOP's, releng also uses them. Although as long as we don't conflict it might not be a terrible idea to merge them.
-Mike
On Sat, 2009-02-14 at 11:54 -0600, Mike McGrath wrote:
My only concern here is we're not the only group with SOP's, releng also uses them. Although as long as we don't conflict it might not be a terrible idea to merge them.
Interesting thought. What purpose does grouping them into a Category serve?
Jesse Keating wrote:
On Sat, 2009-02-14 at 11:54 -0600, Mike McGrath wrote:
My only concern here is we're not the only group with SOP's, releng also uses them. Although as long as we don't conflict it might not be a terrible idea to merge them.
Interesting thought. What purpose does grouping them into a Category serve?
Categories serve several purposes. They replace the directory-type grouping that we did in MoinMoin.
So right now we try to group all SOPs like this: http://fedoraproject.org/wiki/Infrastructure/SOP/SERVICENAME And to extract that information, we have to link to the Special:PrefixIndex page like this: [[Special:PrefixIndex/Infrastructure/SOP]] which takes the user to a search page that finds those SOPs.
Categories in MoinMoin are more flexible than PrefixIndex. With categories, we can look at the Infrastructure SOPs directly by going to: http://fedoraproject.org/wiki/Category:Infrastructure_SOPs This is a page that we can add our own content to (unlike the Special:PrefixIndex page) so we can use it as an end user visible page if we want. (Category:Infrastructure_SOPs is this way. Category:SOPs currently is not so pretty).
We can also have multiple categories per page. For instance: https://fedoraproject.org/wiki/ReleaseEngineering/StringFreezePolicy appears both on Category:Release_Engineering and Category:Localization
We can also have hierarchical categories. Infrastructure SOPs and Release Engineering SOPs are both subcategories of: http://fedoraproject.org/wiki/Category:SOPs Currently we have to browse the tree of categories to see all the subcategory page but category flattening plugins exist.
-Toshio
Jesse Keating wrote:
On Sat, 2009-02-14 at 11:54 -0600, Mike McGrath wrote:
My only concern here is we're not the only group with SOP's, releng also uses them. Although as long as we don't conflict it might not be a terrible idea to merge them.
Interesting thought. What purpose does grouping them into a Category serve?
I've redone Package Database and haproxy so you can see how it works.
Legacy entrypoint: https://fedoraproject.org/wiki/Infrastructure/SOP Redirects to: https://fedoraproject.org/wiki/Category:Infrastructure_SOPs
List of pages where new names are nicely alphabetized.
Click on https://fedoraproject.org/wiki/Package_Database_Infrastructure_SOP
to go to the Package Database page. A template shows the shortcut link to this page on the right. So using the link: https://fedoraproject.org/wiki/SOP:PKGDB
takes you to the same page.
This setup does require one more step by the document creator. The shortcut redirect is not automatically created; you have to create that in addition to the SOP page.
-Toshio
Mike McGrath wrote:
On Fri, 13 Feb 2009, Toshio Kuratomi wrote:
Toshio Kuratomi wrote:
Hey,
I've categorized all of our SOP (Standard Operating Procedure) pages in the [[Category:Infrastructure SOPs]] and made a new page for them: https://fedoraproject.org/wiki/Category:Infrastructure_SOPs
(The old URL redirects there so old, external links are still fine). The index on the page is generated automatically by the category. This means that anytime you create a new SOP simply place this Category tag at the bottom of the page and it will appear here as well::
[[Category:Infrastructure SOPs]]
As you can see from the index on the page, the MoinMoin, hierarchical directory index scheme makes the Category Index a little ugly (everything is listed as beginning with "I" because they all start with "Infrastructure". Additionally, the docs folks recommend that everyone renames pages to be more natural language oriented so that mediawiki's search functionality works better.
If I rename in Mediawiki, there will be redirects from the old names to the new ones. Does anyone mind if I start doing that?
I was thinking of one of the following schemes:
A) Infrastructure/SOP/Baculs => Bacula B) Infrastructure/SOP/Bacula => Bacula SOP
Talked to ianweller on IRC and he recommends:
/wiki/Bacula Infrastructure SOP
and since that's a long URL... having a shortcut (basically a redirect) page name: SOP:BACULA #REDIRECT [[Bacula Infrastructure SOP]]
So http://fedoraproject.org/wiki/SOP:BACULA would take you to the proper place.
My only concern here is we're not the only group with SOP's, releng also uses them. Although as long as we don't conflict it might not be a terrible idea to merge them.
The pages and categories themselves don't conflict since both [[Category: Infrastructure SOPs]] and Bacula Infrastructure SOP have "Infrastructure" in them. For the shortcuts we can either merge the two or we can have:
ISOP:BACULA RSOP:BUILDROOTS
At the moment, I don't see any overlap between the two. Jesse, Do you have an opinion on this?
-Toshio
infrastructure@lists.fedoraproject.org