Wiki Gardening tasks

= Wiki Gardening =

A wiki is a community documentation space. The Fedora Documentation Project is the set of Master Gardeners with the role of helping to train all the other gardeners.

This effort is ongoing, starting with work done at the 2008 FUDCon in Raleigh.

Post-Migration Gardening Checklist for Individual Gardeners
These are tasks for all users and gardeners to do after the migration.


 * 1) Move your old UserName page to the new User:accountname format
 * 2) Make sure to check Watch on pages you edit
 * 3) The [my preferences]  page has an "E-mail" section that allows you to watch changes to your watched pages via email

Everything Below This Point is Subject to Change During Wiki Migration Week
SSIA

New Organizational Schema
There are two major types of pages -- a content-focused page (Content_Area) and a project-focused page (Project_Name). Example namespaces are:


 * Content_Area - Legal,  Packaging
 * Project_Name - SELinux,  DocsProject

Within this single namespace, one or more of these are focuses (highest nesting):


 * Understand -- What is it? Why should I care about it? Understand what this project or content is about.
 * Use -- What and how do I use it? Do stuff with the project or content.
 * Publication -- Different types of publications about using
 * Version -- Publications are versioned by the Fedora version
 * Draft -- A new version stays in draft until after the corresponding Fedora version is released
 * Get_Involved -- How do I join?
 * Refer_also_to -- References

Content_Area|Project_Name/ Understand Use/// /* Publication types */ Use/Communicating_with_other_users/ Use/How_to/ Use/FAQ/ Use/Guide/ Use/Reference/ Get_Involved/ How_to_get_involved/ Types_of_involvement/  /* eg code, test cases, ... */ Contributors_FAQ/ Communicating_with_other_contributors/ Refer_also_to/

Strengths
1. Low barrier to entry for learning and producing web pages.

1. Simple wiki markup language vs.slightly more complex HTML.

1. Version tracking with reversion capabilities.

1. Ability to embed native HTML code.

1. Logging of recent changes.

1. Programmatic extensions through Python.

1. Customization of page appearance via CSS.

1. User authentication by group membership.

1. Access control.

1. Page tracking with email notification.

1. Quick creation of formatted web pages.

1. Page categorization by tags.

Weaknesses
1. Long response time while editing.

1. Notification by email of updates very resource-intensive.

1. Limited scalability.

1. Difficult to generate Doc Book XML from Wiki markup language.

1. Difficult to produce well-formatted PDF files.

1. Requires regular and manually-intensive maintenance to keep docs current and accurate.

Graft on to fedoraproject.org

 * Legal/*
 * ForbiddenItems
 * ProjectName/FooProcess ?
 * .*Meetings.* ?
 * .*Minutes.* ?
 * Communicate
 * Contact
 * ProjectName.*

Graft on to docs.fedoraproject.org

 * Nothing?
 * Docs/ perhaps

= Other FUDCon output (2007-01-11) =

Docs Services Matrix
These represent what Docs provides now and can provide in the future.

Current Situation with Docs
Here is another diagram showing the same thing.

Incorrect Approach for Docs
Here is another diagram showing the same thing.

= Organizing the Wiki =


 * Evangelizing changes

wiki/ Docs/ (formal wiki-based content)

Content_Area|Project_Name/ Understand Use/ How_to_use/ Usage_FAQ/ Communicating_with_other_users/ Get_Involved/ How_to_get_involved/ Types_of_involvement/  # eg code, test cases, ... Contrib_FAQ/ Communicating_with_other_contributors/ Refer_also_to/

What_and_Why
(Optional ideas of what can be on this page)


 * Screenshots
 * What the project, tool, etc. is
 * Why it is
 * Significance within Fedora

= Enabling Wiki Management =


 * Processes for projects to follow
 * page ownership
 * architecture/organization
 * Namespace guidelines
 * Page "versioning"? (0.x = under development, 1.x ready?, something like the Docs versions?. Could help translators keep their copies in sync)


 * Change over some projects
 * SELinux


 * Evangelizing changes
 * Announce
 * Point at fixes done already, process docs


 * Mentors for projects and new contributors
 * email fedora-docs-list or fedora-websites-list
 * Developer Guide links
 * assistance in getting CLA done
 * writing assignments (with mutual agreement)

Other notes --- Jargon Buster What do we do for absolute newbies? (for whom GNOME, KDE, and Xfce are totally meaningless terms)