+ All Categories
Home > Health & Medicine > Sprints and Stacks

Sprints and Stacks

Date post: 06-May-2015
Category:
Upload: anne-gentle
View: 1,241 times
Download: 1 times
Share this document with a friend
Description:
Building a Documentation Community - presented at the Open Help Conference in June 2011
34
Sprints and Stacks Building a Documentation Community Anne Gentle [email protected] Open Help Conference June 2011
Transcript
Page 1: Sprints and Stacks

Sprints and StacksBuilding a Documentation Community

Anne [email protected]

Open Help Conference June 2011

Page 2: Sprints and Stacks

We are tinkerers

Flickr: loozrboy

Page 3: Sprints and Stacks

We are techies

Page 4: Sprints and Stacks

We are Helpers

Not always technical writers, but wanting to make an impact

Flickr: gi

Page 5: Sprints and Stacks

I believe in community

Flickr: ThisParticularGreg

Page 6: Sprints and Stacks

I am… a Content Stacker

OpenStack – Open Source Cloud Computing

Rackspace – Fanatical Support in all we do

Page 7: Sprints and Stacks

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?

Page 8: Sprints and Stacks

Meeting the ChallengesFlickr: marc_smith

Page 9: Sprints and Stacks

Community Documentation

Page 10: Sprints and Stacks

Community – Lessons Learned

Expectations and reality for: Source files Licensing Community Motivations

Page 11: Sprints and Stacks

DocBook & RST

Flickr: myklroventine

Page 12: Sprints and Stacks

Translations

Page 13: Sprints and Stacks

Segmentation

Flickr: theilr

Page 14: Sprints and Stacks

Licensing

Flickr: libraryman

Page 15: Sprints and Stacks

Combining CC and Apache

Page 16: Sprints and Stacks

Bloggers Welcome

Page 17: Sprints and Stacks

Slogging through the Slushpile

Flickr: gruntzooki

Page 18: Sprints and Stacks

Doc Sprints

Timing Experience Participant Selection

Page 19: Sprints and Stacks

Timing is the Thing

Three month release cycles

Design Summit in-person meeting

Now six month release cycles with milestone releases

Flickr: plenty

Page 20: Sprints and Stacks

Contributors and Newbies

Flickr: kholkute

Page 21: Sprints and Stacks

Barriers to Entry

Flickr: AdamKR

Page 22: Sprints and Stacks

Attraction to Sprints

Flickr: ratranch

Page 23: Sprints and Stacks

Data Stacks

Social web integration Web analytics

Page 24: Sprints and Stacks

Comments

Page 25: Sprints and Stacks

Twitter Responses

Page 26: Sprints and Stacks

Planet Blog

Page 27: Sprints and Stacks

Web Analytics

Page 28: Sprints and Stacks

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

Page 29: Sprints and Stacks

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

Page 30: Sprints and Stacks

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

Page 31: Sprints and Stacks

Resolutions

Write DocBook collaboratively for web developers and system administrators (devops, also)

Coach developers to write RST for devs

Page 32: Sprints and Stacks

Resolutions

Automate reference documentation Encourage conversation Build a community around docs and

with docs Iterate repeatedly

Page 33: Sprints and Stacks

Launch and Learn

Flickr: andy_c

Page 34: Sprints and Stacks

Questions?

Anne [email protected]

@annegentle

www.facebook.com/conversationandcommunity

www.linkedin.com/in/annegentle

Flickr: jetheriot


Recommended