0
Open Source
                          Documentation
                          doesn’t have to suck




  OSCON July 2009
T...
Thursday, July 23, 2009

OS is working towards world domination but
not hacking for hackers anymore
docs crucial for OS to...
Challenges

Thursday, July 23, 2009
http://www.flickr.com/photos/maistora
Thursday, July 23, 2009

People are a pain and they all want to do their own thing
Di...
http://www.flickr.com/photos/eyesore9
Thursday, July 23, 2009

different skill sets that you didn’t hire
http://www.flickr.com/photos/cute-is-what-i-aim-for
Thursday, July 23, 2009

we’re cats and we scratch our own itches
Documentation is like sex;
                           when it's good,
                        it's very, very good,
      ...
Opportunities

Thursday, July 23, 2009
http://www.flickr.com/photos/maistora
Thursday, July 23, 2009

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

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

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

teamwork and passion are built in
Experiments

Thursday, July 23, 2009

Our attitude: throw it on the wall and see if it sticks
http://www.flickr.com/photos/martyn
Thursday, July 23, 2009

Opened docs editing
got more edits but bad “team” definition
ov...
http://www.flickr.com/photos/jamaladi
Thursday, July 23, 2009

Sprints, both physical and virtual
help people connect and c...
http://www.flickr.com/photos/brianarn
Thursday, July 23, 2009

Roadmap - how to get to where we need to be
Totally crazy fo...
http://www.flickr.com/photos/practicalowl
Thursday, July 23, 2009

Communication: not everyone works the same way; need to ...
Lessons

Thursday, July 23, 2009

Overall lessons so far
http://www.flickr.com/photos/hebe
Thursday, July 23, 2009

cheerleading is hard and exhausting
but you *have* to do it
keep...
http://www.flickr.com/photos/colinwhittaker
Thursday, July 23, 2009

the work/docs itself AND the community are both equall...
http://www.flickr.com/photos/johnlemon
Thursday, July 23, 2009

helping others help you is of utmost importance
creating ne...
http://www.flickr.com/photos/bogdansuditu
Thursday, July 23, 2009

have goals, even if you don’t hit them
motivation and me...
What’s next?

Thursday, July 23, 2009
Thursday, July 23, 2009

For Drupal : IA Redesign, team defining/building
WOSdocs




                     http://writingopensource.com
Thursday, July 23, 2009

More important, OS help OS
not just...
Addison Berry


                          http://rocktreesky.com

                          add1sun

Thursday, July 23, 20...
http://www.flickr.com/photos/atc
Thursday, July 23, 2009

Let’s share
Upcoming SlideShare
Loading in...5
×

Open Source Docs don't have to suck

1,369

Published on

Published in: Technology, News & Politics
1 Comment
3 Likes
Statistics
Notes
No Downloads
Views
Total Views
1,369
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
40
Comments
1
Likes
3
Embeds 0
No embeds

No notes for slide

Transcript of "Open Source Docs don't have to suck"

  1. 1. Open Source Documentation doesn’t have to suck OSCON July 2009 Thursday, July 23, 2009
  2. 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. 3. Challenges Thursday, July 23, 2009
  4. 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. 5. http://www.flickr.com/photos/eyesore9 Thursday, July 23, 2009 different skill sets that you didn’t hire
  6. 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. 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. 8. Opportunities Thursday, July 23, 2009
  9. 9. http://www.flickr.com/photos/maistora Thursday, July 23, 2009 Diff perspectives can create unique solutions
  10. 10. http://www.flickr.com/photos/eyesore9 Thursday, July 23, 2009 find skills you didn’t expect or know you needed
  11. 11. http://www.flickr.com/photos/dearbarbz365 Thursday, July 23, 2009 appealing for people who want to learn free training for work
  12. 12. http://flickr.com/photos/emurray Thursday, July 23, 2009 teamwork and passion are built in
  13. 13. Experiments Thursday, July 23, 2009 Our attitude: throw it on the wall and see if it sticks
  14. 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. 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. 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. 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. 18. Lessons Thursday, July 23, 2009 Overall lessons so far
  19. 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. 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. 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. 22. http://www.flickr.com/photos/bogdansuditu Thursday, July 23, 2009 have goals, even if you don’t hit them motivation and metrics
  23. 23. What’s next? Thursday, July 23, 2009
  24. 24. Thursday, July 23, 2009 For Drupal : IA Redesign, team defining/building
  25. 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. 26. Addison Berry http://rocktreesky.com add1sun Thursday, July 23, 2009
  27. 27. http://www.flickr.com/photos/atc Thursday, July 23, 2009 Let’s share
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×