Documentation Needs?How FLOSS Manuals Can
Help
Janet SwisherAnne Gentle
Texas Linux FestApril 10, 2010
Does your documentation suck?
Flickr: Theresa Thompson
You're not alone.
I find it incredibly hard to make sure that the users get the right information from the docs. On the one hand, it seems that there is already too much information as people miss things that are already in there. On the other hand, there is always information that people are looking for, and that is not in the docs. -- Gaël Varoquaux, developer, Mayavi2 project
You're not alone.
You could burn through a big budget trying to be everything to all users.
Pick your priorities.
Flickr:alancleaver_2000
"Documentation is hard."
"Let's go programming!"
It's hard for programmers to take a user's perspective.
Flickr:Yandle
Traditional FOSS doc tools are powerful, but hard for non-techies to use.
Flickr: couragextoxlive
Wikis are easy to use but hard to manage for documentation.
If only you could find...
... people who like writing documentation. ... tools that are easy to use and support multiple outputs.
FLOSS Manuals is
FLOSS Manuals is ...
... reading ...
a collection of books -- over 40 manuals on free software
... collaborative writing and editing ...
... translating ...
Localized FLOSS Manuals sites: • Farsi• Finnish• Dutch
Translations in progress in Spanish, Greek, German, Portuguese, Russian, Chinese, Arabic, Vietnamese ...
... remixing and publishing.
FLOSS Manuals is
• the invention of Adam Hyde's -- an artist who taught workshops about open source tools and was frustrated with the materials available
• about three years old (site started in May 2007) • a non-profit organization (FLOSS Manuals Stichting,
incorporated in the Netherlands)
Objavi
Try it at http://objavi.flossmanuals.net Objavi is distributed under GPL 2+. The source is available via http://booki-dev.flossmanuals.net/git?p=objavi2.git
Booki
http://www.booki.cc/
We also like to do book sprints.
July 2008: Inkscape, ParisAug 2008: OLPC/SugarLabs, AustinNov 2008: Internet Censorship, upstate New YorkFeb 2009: Digital Foundations, NYCMar 2009: Firefox, Palm SpringsMar 2009: Introduction to the Command Line, BostonApr 2009: PureData, NYC & BerlinMay 2009: CiviCRM, Truckee, CADec 2009: Etoys, virtual Jan 2010: Collaboration, BerlinApril 2010: Mifos, virtual
How can FLOSS Manuals help your project? We have ideas.
Use the FLOSS Manuals tools to write your docs. http://flossmanuals.net
http://booki.cc (alpha, ask via email first)
Join the FLOSS Manuals community.
http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
Throw a book sprint.
We've written how-to books aboutFLOSS Manuals and book sprints. We write manuals, after all.
See FLOSS Manuals in action
Mini-sprint for Firefox 3.6Tomorrow, Sunday April 11th11 am to 4 pm
Genuine Joe Coffeehouse, 2001 West Anderson Lane Other sprinters also welcome!
Thanks! Discuss!
Janet Swisher: [email protected] Gentle: [email protected]
FLOSS Manuals: http://en.flossmanuals.net