際際滷

際際滷Share a Scribd company logo
Open Source
                          Documentation
                          doesnt have to suck




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

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

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

People are a pain and they all want to do their own thing
Diff cultures can cause con鍖ict
http://www.鍖ickr.com/photos/eyesore9
Thursday, July 23, 2009

different skill sets that you didnt hire
http://www.鍖ickr.com/photos/cute-is-what-i-aim-for
Thursday, July 23, 2009

were cats and we scratch our own itches
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
Opportunities

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

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

鍖nd skills you didnt expect or know you needed
http://www.鍖ickr.com/photos/dearbarbz365
Thursday, July 23, 2009

appealing for people who want to learn
free training for work
http://鍖ickr.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.鍖ickr.com/photos/martyn
Thursday, July 23, 2009

Opened docs editing
got more edits but bad team de鍖nition
overall plus with some peripheral things to work on still
http://www.鍖ickr.com/photos/jamaladi
Thursday, July 23, 2009

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

Roadmap - how to get to where we need to be
Totally crazy for Drupal, where we dont do roadmaps
just started, well see
http://www.鍖ickr.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
Lessons

Thursday, July 23, 2009

Overall lessons so far
http://www.鍖ickr.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
http://www.鍖ickr.com/photos/colinwhittaker
Thursday, July 23, 2009

the work/docs itself AND the community are both equally important
no way to sustain without both
http://www.鍖ickr.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
http://www.鍖ickr.com/photos/bogdansuditu
Thursday, July 23, 2009

have goals, even if you dont hit them
motivation and metrics
Whats next?

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

For Drupal : IA Redesign, team de鍖ning/building
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
Addison Berry


                          http://rocktreesky.com

                          add1sun

Thursday, July 23, 2009
http://www.鍖ickr.com/photos/atc
Thursday, July 23, 2009

Lets share

More Related Content

Open Source Docs don't have to suck