Date post: | 06-May-2015 |
Category: |
Health & Medicine |
Upload: | anne-gentle |
View: | 1,241 times |
Download: | 1 times |
Sprints and StacksBuilding a Documentation Community
Anne [email protected]
Open Help Conference June 2011
We are tinkerers
Flickr: loozrboy
We are techies
We are Helpers
Not always technical writers, but wanting to make an impact
Flickr: gi
I believe in community
Flickr: ThisParticularGreg
I am… a Content Stacker
OpenStack – Open Source Cloud Computing
Rackspace – Fanatical Support in all we do
Welcome to Now
Our Challenge: Never before have we had tools for collaboration, instant communication, project tracking, and data gathering.
How do we harness the power of community for documentation?
Meeting the ChallengesFlickr: marc_smith
Community Documentation
Community – Lessons Learned
Expectations and reality for: Source files Licensing Community Motivations
DocBook & RST
Flickr: myklroventine
Translations
Segmentation
Flickr: theilr
Licensing
Flickr: libraryman
Combining CC and Apache
Bloggers Welcome
Slogging through the Slushpile
Flickr: gruntzooki
Doc Sprints
Timing Experience Participant Selection
Timing is the Thing
Three month release cycles
Design Summit in-person meeting
Now six month release cycles with milestone releases
Flickr: plenty
Contributors and Newbies
Flickr: kholkute
Barriers to Entry
Flickr: AdamKR
Attraction to Sprints
Flickr: ratranch
Data Stacks
Social web integration Web analytics
Comments
Twitter Responses
Planet Blog
Web Analytics
Measure the Help
Customer support and help sites New vs. returning
visitors Searches that had
zero yield Search results to
site exits ratio Download
completion rates (if relevant)
Flickr: HeavyWeightGeek
Engagement Indicators
Number of comments on content
Number of comments responded to
Response time on the comments
Number of edits Volume on
discussion boards Flickr: atomicjeep
Pitfalls
Too much content, not enough engagement.
Another community could take all the major players attention.
Dilution and repetition.
High barriers to entry. Flickr: docpop
Resolutions
Write DocBook collaboratively for web developers and system administrators (devops, also)
Coach developers to write RST for devs
Resolutions
Automate reference documentation Encourage conversation Build a community around docs and
with docs Iterate repeatedly
Launch and Learn
Flickr: andy_c
Questions?
Anne [email protected]
@annegentle
www.facebook.com/conversationandcommunity
www.linkedin.com/in/annegentle
Flickr: jetheriot