Open Source Documentation OSCON July 2009 doesn’t have to suck Thursday, July 23, 2009
Jan 21, 2015
Open SourceDocumentation
OSCON July 2009
doesn’t have to suck
Thursday, July 23, 2009
Thursday, July 23, 2009
OS is working towards world domination butnot hacking for hackers anymoredocs crucial for OS to spread beyond hackers
Challenges
Thursday, July 23, 2009
http://www.flickr.com/photos/maistoraThursday, July 23, 2009
People are a pain and they all want to do their own thingDiff cultures can cause conflict
http://www.flickr.com/photos/eyesore9Thursday, July 23, 2009
different skill sets that you didn’t hire
http://www.flickr.com/photos/cute-is-what-i-aim-forThursday, 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,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.flickr.com/photos/maistoraThursday, July 23, 2009
Diff perspectives can create unique solutions
http://www.flickr.com/photos/eyesore9Thursday, July 23, 2009
find skills you didn’t expect or know you needed
http://www.flickr.com/photos/dearbarbz365Thursday, July 23, 2009
appealing for people who want to learnfree training for work
http://flickr.com/photos/emurrayThursday, 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/martynThursday, July 23, 2009
Opened docs editinggot more edits but bad “team” definitionoverall plus with some peripheral things to work on still
http://www.flickr.com/photos/jamaladiThursday, July 23, 2009
Sprints, both physical and virtualhelp people connect and communicateneed to work out better coordination
http://www.flickr.com/photos/brianarnThursday, July 23, 2009
Roadmap - how to get to where we need to beTotally crazy for Drupal, where we “don’t do roadmaps”just started, we’ll see
http://www.flickr.com/photos/practicalowlThursday, July 23, 2009
Communication: not everyone works the same way; need to broaden the conversationold: mailing list, issue queuenew: meetings (irc), blogging, in person, news page
Lessons
Thursday, July 23, 2009
Overall lessons so far
http://www.flickr.com/photos/hebeThursday, July 23, 2009
cheerleading is hard and exhaustingbut you *have* to do itkeep it in the “news” or people forget
http://www.flickr.com/photos/colinwhittakerThursday, July 23, 2009
the work/docs itself AND the community are both equally importantno way to sustain without both
http://www.flickr.com/photos/johnlemonThursday, July 23, 2009
helping others help you is of utmost importancecreating new leaderscreate opportunities for unknown skills to shine
http://www.flickr.com/photos/bogdansudituThursday, July 23, 2009
have goals, even if you don’t hit themmotivation and metrics
What’s next?
Thursday, July 23, 2009
Thursday, July 23, 2009
For Drupal : IA Redesign, team defining/building
WOSdocs
http://writingopensource.comThursday, July 23, 2009
More important, OS help OSnot just one person or one project will make OS docs kick ass
Addison Berry
http://rocktreesky.com
add1sun
Thursday, July 23, 2009
http://www.flickr.com/photos/atcThursday, July 23, 2009
Let’s share