On Mon, Aug 02, 2010 at 08:50:41PM +1000, David Timms wrote: > On 02/08/10 09:07, Karsten Wade wrote: > > On Fri, Jul 30, 2010 at 08:40:44PM -0400, Christopher R. Antila wrote: > ... > > This scheme gives two types of documentation: a fixed release guide > > that can be printed and referenced; a more flowing set of wiki pages > > with various quantities and qualities of information. > Is this scheme already used in other fields of Fedora ? > > Anyway, makes a lot of sense: developer (writers) just commit > fixes/changes to the wiki whenever they can and the (print) manual gets > updated with information as needed. With the exception of back-end tooling that mostly hurts the Big Guide writers, it's a pretty nice balance. > I do find that long wiki pages can be overwhelming to use. You see it > load, and the web browser vertical scroll bar pointer ends up tiny. You > scroll a few pages down, and realize that you simply don't have the time > to read that much, and try finding alternate material. Agreed, and MediaWiki has guidelines about keeping pages short that we an use. We can also use transclusion, which lets us included multiple individual pages in to one page, where desired. For example, if the topic were Audacity, you create: * A series of stand-alone topic-specific pages about Audacity (topics can be reused across tools): [[Recording with Audacity]], [[Editing with Audacity]], etc. * Each topic-specific page can be further broken down to sub-topics to keep the pages light and focused. * Each page is in one or more categories, so the category pages become a lightweight table-of-contents approach, e.g.: http://fedoraproject.org/wiki/Fonts redirects to http://fedoraproject.org/wiki/Category:Fonts If you drill down in to those subcategories, you'll find dozens of pages in the subcategories. Anyway, I think we can make a set of reasonable nestings of categories and a template page to follow, then highlight the main steps to start and maintain an audio tool wiki page. > For a music spin, is there an easy process to extract the contents of > the wiki pages so that they can be added as ?html? to a spin. (eg assume > user doesn't have internet where they are using the spin) ? There is a package 'python-mwlibs' that includes tools for extracting things from a MediaWiki instance. We use it for converting out an XML that is about 80% useable as-is, it could probably make XHTML easily. - Karsten -- name: Karsten 'quaid' Wade, Sr. Community Gardener team: Red Hat Community Architecture uri: http://TheOpenSourceWay.org/wiki gpg: AD0E0C41
Attachment:
pgpBPqdPj2cnL.pgp
Description: PGP signature
_______________________________________________ music mailing list music@xxxxxxxxxxxxxxxxxxxxxxx https://admin.fedoraproject.org/mailman/listinfo/music