Archive:Docs Project FUDCon Boston 2007 hackfest whiteboard
From FedoraProject
(Redirected from Docs Project FUDCon Boston 2007 hackfest whiteboard)
Contents |
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?
