Archive:Docs Project FUDCon Boston 2007 hackfest whiteboard

DocsProject/FUDConBoston2/Hackfest/ Whiteboard

Refer to Docs_Project_FUDCon_Boston_2007_hackfest for most information.

Goals

• Publish Docs/Drafts/DesktopUserGuide to Docs/DesktopUserGuide
• Announcement to boot
• Updates to DocumentationGuide
• Work directly in XML
• Chop out old
• Put in new
• Plone instance running prototype front page
• Talk with MairinDuffy
• Coordinate with Infrastructure (damaestro, abadger99)
• Tools work (TBD)

DUG publishing

• JohnBabich working on this (via IRC) with KarstenWade

Documentation Guide hacking

1 Work out the future of this guide

• Do we need a stand alone, XML-based document for this?
• Yes, we need a self-referential guide that teaches how to write itself

Tasks

1 Add self-referential materials to example-tutorial

• Common content across this and the documentation-guide
• Two files: document-template.xml and example-tutorial.xml
• document-template.xml -- simple document to paste content into and proceed
• example-tutorial.xml -- similar content plus more, with many explanatory comment blocks
• documentation-guide pulls in example-tutorial.xml as a section

2 Pull content from the documentation-guide until it has only:

• Self-referential XML teaching materials
• How-to use editors (Emacs, Vi)
• Links to style guide and process docs on the Wiki
• Links to CVS, how to get involved, etc. on the Wiki
• ?enough?