The document discusses the challenges and opportunities of open source documentation. It notes that open source is no longer just for hackers and documentation is crucial for its spread. However, documentation faces challenges like differing skills and perspectives among contributors. The document advocates for experiments like opening documentation to broader editing and using sprints to improve collaboration. It provides lessons like the need for cheerleading, balancing the documentation work with community-building, and helping new leaders emerge. The document concludes by calling for continued work on documentation across open source projects and sharing experiences to improve documentation overall.

1. Open Source
Documentation
doesn’t have to suck
OSCON July 2009
Thursday, July 23, 2009

2. Thursday, July 23, 2009
OS is working towards world domination but
not hacking for hackers anymore
docs crucial for OS to spread beyond hackers

3. Challenges
Thursday, July 23, 2009

4. http://www.flickr.com/photos/maistora
Thursday, July 23, 2009
People are a pain and they all want to do their own thing
Diff cultures can cause conflict

5. http://www.flickr.com/photos/eyesore9
Thursday, July 23, 2009
different skill sets that you didn’t hire

6. http://www.flickr.com/photos/cute-is-what-i-aim-for
Thursday, July 23, 2009
we’re cats and we scratch our own itches

7. Documentation is like sex;
when it's good,
it's very, very good,
and when it's bad,
it's better than nothing.
Thursday, July 23, 2009
in OS typically the standards for docs are low

8. Opportunities
Thursday, July 23, 2009

9. http://www.flickr.com/photos/maistora
Thursday, July 23, 2009
Diff perspectives can create unique solutions

10. http://www.flickr.com/photos/eyesore9
Thursday, July 23, 2009
find skills you didn’t expect or know you needed

11. http://www.flickr.com/photos/dearbarbz365
Thursday, July 23, 2009
appealing for people who want to learn
free training for work

12. http://flickr.com/photos/emurray
Thursday, July 23, 2009
teamwork and passion are built in

13. Experiments
Thursday, July 23, 2009
Our attitude: throw it on the wall and see if it sticks

14. http://www.flickr.com/photos/martyn
Thursday, July 23, 2009
Opened docs editing
got more edits but bad “team” definition
overall plus with some peripheral things to work on still

15. http://www.flickr.com/photos/jamaladi
Thursday, July 23, 2009
Sprints, both physical and virtual
help people connect and communicate
need to work out better coordination

16. http://www.flickr.com/photos/brianarn
Thursday, July 23, 2009
Roadmap - how to get to where we need to be
Totally crazy for Drupal, where we “don’t do roadmaps”
just started, we’ll see

17. http://www.flickr.com/photos/practicalowl
Thursday, July 23, 2009
Communication: not everyone works the same way; need to broaden the conversation
old: mailing list, issue queue
new: meetings (irc), blogging, in person, news page

18. Lessons
Thursday, July 23, 2009
Overall lessons so far

19. http://www.flickr.com/photos/hebe
Thursday, July 23, 2009
cheerleading is hard and exhausting
but you *have* to do it
keep it in the “news” or people forget

20. http://www.flickr.com/photos/colinwhittaker
Thursday, July 23, 2009
the work/docs itself AND the community are both equally important
no way to sustain without both

21. http://www.flickr.com/photos/johnlemon
Thursday, July 23, 2009
helping others help you is of utmost importance
creating new leaders
create opportunities for unknown skills to shine

22. http://www.flickr.com/photos/bogdansuditu
Thursday, July 23, 2009
have goals, even if you don’t hit them
motivation and metrics

23. What’s next?
Thursday, July 23, 2009

24. Thursday, July 23, 2009
For Drupal : IA Redesign, team defining/building

25. WOSdocs
http://writingopensource.com
Thursday, July 23, 2009
More important, OS help OS
not just one person or one project will make OS docs kick ass

26. Addison Berry
http://rocktreesky.com
add1sun
Thursday, July 23, 2009

27. http://www.flickr.com/photos/atc
Thursday, July 23, 2009
Let’s share