I thought I should introduce myself to the packaging list and devel list. I'm here to help with documentation in general and packaging related wiki pages specifically. This includes the Packaging:, PackageMaintainers/*, and PackagingDrafts/* pages of the wiki. My immediate tasks include helping with page naming and categories to aid with searches. I am also available to assist with any proofreading.
My $dayjob is mostly teaching and mostly for Red Hat (RHCE and RHCA classes). I've been *nix user and admin and instructor for years but I am fairly new as contributer. I have started out helping with the Fedora Docs Project and after meeting several people at FUDConF11, accepted the lead on the docs team side for the packaging docs. It is really a liaison position between the docs team and the packaging team and other contributors to packaging documentation. In addition to the renaming, categorizing, and proofreading, I am sure I will be helping with moving the Packaging Guidelines to the CMS when we decide on a system and I have DocBook experience to assist if any of the pages move to XML for other publishing.
From a docs side, the first thing that needs to occur is some renaming and categorization. Since it is a wiki and it is easy to undo changes, I am going to dig in add some categories and then start some page renaming. I won't be offended if anything gets undone but I hope that those who have worked so hard to get the pages where they are will also jump in with some suggestions.
Here are some links that will help explain what needs to occur:
https://fedoraproject.org/wiki/Help:Wiki_structure - This page explains page naming, namespaces, and categories.
https://fedoraproject.org/wiki/User:Ianweller/Wiki_tip_of_the_week - The first week is about moving pages (preview available now)
For example the current page [[PackageMaintainers/MaintainerResponsibility]] would not currently be found in a search for either "package" or "maintainers" because the mediawiki search uses whole word searches only. We also want to eliminate the hierarchy. A better name would be [[Package maintainer responsibilities]].
I was looking at the page https://fedoraproject.org/wiki/PackageMaintainers and see a lot of good naming suggestions in the link names and descriptions. With renaming, categories, and subcategories we can even generate a similar page automatically.
Check out the fonts pages for an example: https://fedoraproject.org/wiki/Category:Fonts
Something similar can be done for https://fedoraproject.org/wiki/Category:Package_Maintainers
I am still looking for suggestions for subcategories for the Package Maintainers pages.
If there are pages that are old or no longer in use they can be moved to the Archive namespace. Simply click the move button at the top of the page and add Archive: at the beginning of the name. For instance PackageMaintainers/FC3Status has recently been moved to Archive:PackageMaintainers/FC3Status Anything pointing to the original name is automatically redirected to the new name. This way the page still exists and can be found with an advanced search but will not appear in default search that a visitor to the site may use. Can PackageMaintainers/PackageStatus/CompsF9Missing also be archived?
Finally, there is a fedora-wiki mailing list that has announcements and tips, but is also a good place to ask questions and discuss names and categories. https://admin.fedoraproject.org/mailman/listinfo/fedora-wiki
And I am often on #fedora-docs as laubersm (or some variation) but anyone there should also be able to help.
I look forward to helping and I appreciate any suggestions.
Thanks,
Susan
--
Susan Lauber, (RHCX, RHCA, RHCSS)
Lauber System Solutions, Inc.
http://www.laubersolutions.com
gpg: 15AC F794 A3D9 64D1 D9CE 4C26 EFC3 11C2 BFA1 0974
-- fedora-devel-list mailing list fedora-devel-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/fedora-devel-list
