SlideShare a Scribd company logo
Sprints and StacksBuilding a Documentation CommunityAnne Gentleanne@openstack.orgOpen Help Conference June 2011
We are tinkerersFlickr: loozrboy
We are techiesFlickr: laurenkeith
We are HelpersNot always technical writers, but wanting to make an impactFlickr: gi
I believe in communityFlickr: ThisParticularGreg
I am… a Content StackerOpenStack – Open Source Cloud ComputingRackspace – Fanatical Support in all we do
Welcome to NowOur 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 LearnedExpectations and reality for:Source filesLicensingCommunity Motivations
DocBook & RSTFlickr: myklroventine
Translations
SegmentationFlickr: theilr
LicensingFlickr: libraryman
Combining CC and Apache
Bloggers Welcome
Slogging through the SlushpileFlickr: gruntzooki
Doc SprintsTimingExperienceParticipant Selection
Timing is the ThingThree month release cyclesDesign Summit in-person meetingNow six month release cycles with milestone releasesFlickr: plenty
Contributors and NewbiesFlickr: kholkute
Barriers to EntryFlickr: AdamKR
Attraction to SprintsFlickr: ratranch
Data StacksSocial web integrationWeb analytics
Comments
Twitter Responses
Planet Blog
Web Analytics
Measure the HelpCustomer support and help sites New vs. returning visitorsSearches that had zero yieldSearch results to site exits ratioDownload completion rates (if relevant)Flickr: HeavyWeightGeek
Engagement IndicatorsNumber of comments on contentNumber of comments responded toResponse time on the commentsNumber of editsVolume on discussion boardsFlickr: atomicjeep
PitfallsToo much content, not enough engagement.Another community could take all the major players attention.Dilution and repetition.High barriers to entry. Flickr: docpop
ResolutionsWrite DocBook collaboratively for web developers and system administrators (devops, also)Coach developers to write RST for devs
ResolutionsAutomate reference documentationEncourage conversationBuild a community around docs and with docsIterate repeatedly
Launch and LearnFlickr:andy_c
Questions?Anne Gentlewww.justwriteclick.comanne@openstack.org@annegentlewww.facebook.com/conversationandcommunitywww.linkedin.com/in/annegentleFlickr: jetheriot

More Related Content

PDF
Content Systems Architecture: Approaches in a decoupled world
PPTX
Social Media Staffing and Policies
PPTX
Social Media Policies for UJA FEderation of NY Synagogues
PPT
Catastrophic Disasters in China PART II
PPTX
Living near Railways: Discourses of Control, Choice and Compromise
PPTX
Psypag11 - Living near Railways, part of the QMiP symposium
PPTX
How to tell if your website is a success (or not)
PDF
Innovation, Services & Practices at the Darien Library
Content Systems Architecture: Approaches in a decoupled world
Social Media Staffing and Policies
Social Media Policies for UJA FEderation of NY Synagogues
Catastrophic Disasters in China PART II
Living near Railways: Discourses of Control, Choice and Compromise
Psypag11 - Living near Railways, part of the QMiP symposium
How to tell if your website is a success (or not)
Innovation, Services & Practices at the Darien Library

Similar to Sprints and Stacks (20)

PPTX
Social Media, Social Networking, and Social Relevance in Tech Comm
PPTX
Social web for Tech Comm, STC March 2013
PDF
Open Source Software Needs You!
PDF
Community update on flink 1.9 and How to Contribute to Flink
PPTX
The Avalon Media System: Implementation and Community
PPT
library 2.0
PPTX
Avalon Media System update
PPTX
Massively maintained accessibility: WordPress
PDF
How to Contribute to Apache Flink (and Flink at the Apache Software Foundation)
PDF
Introduction to Omeka
PPT
Planning New Media Projects: What Every Manager Should Know
PDF
Webinar: How to contribute to Apache Flink - Robert Metzger
PDF
Open Writing ! - Collaborative Authoring on Apache’s First Open-Source Cloud ...
PPT
Realizing the Benefits for Scholars and the Digital Library Community Through...
PPTX
RePosit presentation for Symplectic User Conference 2011
PPTX
March 18 NISO Two Part Webinar: Is Granularity the Next Discovery Frontier? P...
PPTX
RCOS Mid-Semester Presentation
PPT
OSCELOT
PDF
Apache Software Foundation: How To Contribute, with Apache Flink as Example (...
PPTX
August Flink Community Update
Social Media, Social Networking, and Social Relevance in Tech Comm
Social web for Tech Comm, STC March 2013
Open Source Software Needs You!
Community update on flink 1.9 and How to Contribute to Flink
The Avalon Media System: Implementation and Community
library 2.0
Avalon Media System update
Massively maintained accessibility: WordPress
How to Contribute to Apache Flink (and Flink at the Apache Software Foundation)
Introduction to Omeka
Planning New Media Projects: What Every Manager Should Know
Webinar: How to contribute to Apache Flink - Robert Metzger
Open Writing ! - Collaborative Authoring on Apache’s First Open-Source Cloud ...
Realizing the Benefits for Scholars and the Digital Library Community Through...
RePosit presentation for Symplectic User Conference 2011
March 18 NISO Two Part Webinar: Is Granularity the Next Discovery Frontier? P...
RCOS Mid-Semester Presentation
OSCELOT
Apache Software Foundation: How To Contribute, with Apache Flink as Example (...
August Flink Community Update
Ad

More from Anne Gentle (20)

PDF
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
PPTX
Docs as Code: Publishing Processes for API Experiences
PDF
Make an Instant Website with Webhooks
PDF
Docs Like Code
PDF
Docs Like Code: Strategies and Stories
PPTX
Deploying Apps on OpenStack
PDF
Collaborating on GitHub for Open Source Documentation
PPTX
Journey into Continuous Glucose Monitoring Technology as a Parent
PPTX
Collaborating on GitHub for Open Source Documentation
PDF
Git and GitHub for Documentation
PPTX
Writing a Technical Talk Proposal
PDF
Women in tech: Be that light
PDF
You'll Never Look at Developer Support the Same Way Again
PDF
So You Want to be an OpenStack Contributor
PPTX
OpenStack Doc Overview for Boot Camp
PPT
OpenStack How To - PyLadies ATX
PPT
Women of OpenStack breakfast welcome
PDF
OpenStack documentation & translation management 2012_summit
PPTX
OpenStack Documentation in the Open
PPTX
OpenStack Documentation Projects and Processes
Inclusive, Accessible Tech: Bias-Free Language in Code and Configurations
Docs as Code: Publishing Processes for API Experiences
Make an Instant Website with Webhooks
Docs Like Code
Docs Like Code: Strategies and Stories
Deploying Apps on OpenStack
Collaborating on GitHub for Open Source Documentation
Journey into Continuous Glucose Monitoring Technology as a Parent
Collaborating on GitHub for Open Source Documentation
Git and GitHub for Documentation
Writing a Technical Talk Proposal
Women in tech: Be that light
You'll Never Look at Developer Support the Same Way Again
So You Want to be an OpenStack Contributor
OpenStack Doc Overview for Boot Camp
OpenStack How To - PyLadies ATX
Women of OpenStack breakfast welcome
OpenStack documentation & translation management 2012_summit
OpenStack Documentation in the Open
OpenStack Documentation Projects and Processes
Ad

Recently uploaded (20)

PPTX
CEREBROVASCULAR DISORDER.POWERPOINT PRESENTATIONx
PDF
Human Health And Disease hggyutgghg .pdf
PPTX
Chapter-1-The-Human-Body-Orientation-Edited-55-slides.pptx
PPTX
LUNG ABSCESS - respiratory medicine - ppt
PPTX
CME 2 Acute Chest Pain preentation for education
PDF
Rheumatoid arthritis RA_and_the_liver Prof AbdelAzeim Elhefny Ain Shams Univ...
PPTX
surgery guide for USMLE step 2-part 1.pptx
PPTX
Electromyography (EMG) in Physiotherapy: Principles, Procedure & Clinical App...
PPTX
Gastroschisis- Clinical Overview 18112311
PPTX
Important Obstetric Emergency that must be recognised
PDF
NEET PG 2025 | 200 High-Yield Recall Topics Across All Subjects
PPTX
NEET PG 2025 Pharmacology Recall | Real Exam Questions from 3rd August with D...
PPT
ASRH Presentation for students and teachers 2770633.ppt
PPTX
post stroke aphasia rehabilitation physician
PDF
CT Anatomy for Radiotherapy.pdf eryuioooop
DOCX
RUHS II MBBS Microbiology Paper-II with Answer Key | 6th August 2025 (New Sch...
PPTX
Fundamentals of human energy transfer .pptx
PPT
CHAPTER FIVE. '' Association in epidemiological studies and potential errors
PPTX
Pathophysiology And Clinical Features Of Peripheral Nervous System .pptx
PPTX
Respiratory drugs, drugs acting on the respi system
CEREBROVASCULAR DISORDER.POWERPOINT PRESENTATIONx
Human Health And Disease hggyutgghg .pdf
Chapter-1-The-Human-Body-Orientation-Edited-55-slides.pptx
LUNG ABSCESS - respiratory medicine - ppt
CME 2 Acute Chest Pain preentation for education
Rheumatoid arthritis RA_and_the_liver Prof AbdelAzeim Elhefny Ain Shams Univ...
surgery guide for USMLE step 2-part 1.pptx
Electromyography (EMG) in Physiotherapy: Principles, Procedure & Clinical App...
Gastroschisis- Clinical Overview 18112311
Important Obstetric Emergency that must be recognised
NEET PG 2025 | 200 High-Yield Recall Topics Across All Subjects
NEET PG 2025 Pharmacology Recall | Real Exam Questions from 3rd August with D...
ASRH Presentation for students and teachers 2770633.ppt
post stroke aphasia rehabilitation physician
CT Anatomy for Radiotherapy.pdf eryuioooop
RUHS II MBBS Microbiology Paper-II with Answer Key | 6th August 2025 (New Sch...
Fundamentals of human energy transfer .pptx
CHAPTER FIVE. '' Association in epidemiological studies and potential errors
Pathophysiology And Clinical Features Of Peripheral Nervous System .pptx
Respiratory drugs, drugs acting on the respi system

Sprints and Stacks

Editor's Notes

  • #7: I am a content stacker at Rackspace, here’s where I think we’re going
  • #9: there are challenges to using these tools – social media amplifies errors and heightens drama in communities while also enabling more voices and sites.AmplificationDramaToo many channelsToo much datamap represents the number of unique authors in each Usenet newsgroup who appeared in the current year, 2003.
  • #10: Making it work anyway.Use sprints, strategic stacks with analytics, licensing that enables tinkering, and purposeful collaboration to tune your open docs strategy. I’m going to walk through three areas: Community, Sprints, and Stacks of Data.
  • #12: We have a schism – DocBook and RST. I have so far divided by audience since DocBook deliverables are more advanced, PDF output and comments enabled.
  • #13: Translation has not yet been activated. I have only seen a Korean wiki pop up. I don’t know if tooling is the problem or if people just write in English to get the attention of the wide audience.
  • #14: One hard tack and four softies.Despite writing the process up in detail, so far devs write RST, no one really writes DocBook yet.
  • #15: First call was to Belinda Lopez, her advice was – work out challenges with licensing. But they had already decided on Apache. I challenged the use of Apache for content, it’s just hard to interpret, CC is much easier to explain. Still working with lawyers for wording.
  • #16: I challenged the use of Apache for content, it’s just hard to interpret, CC is much easier to explain. Still working with lawyers for wording.Now moving towards licensing for training materials – slide decks, check. But what about lab setup, video, workshops, and exams? Learning how to license those.
  • #17: By combining CC and Apache I can now welcome blogger’s material
  • #18: Publishers want OpenStack content. I feel like I’m in a fight to be an acquisitions editor some days. Everyone wants an OpenStack book, or blog entries about OpenStack to publishion their site. I was surprised at this.
  • #20: Originally had doc sprint during design summit, moved it to earlier dateExpectation – to hold these regularly, reality, releases dictated when to hold themTiming has changed again to six month releases with milestone releases in between. Doc sprints need a rethink.
  • #21: Eric Holscher – read the docs - said at Pycon, Devs need to write for other devs – strongly believe what ReadTheDocs.org guy preaches now. This is a 180 degree turn for me.
  • #22: Barrier to entry is quite high with BZR and Launchpad. Yes I can walk through Windows contributors but they give up early. We are moving to git for code storage – how will that affect doc contributions? Doc contributors need access to people they can interview incessantly. Plus they need access to hardware, big time. Neither are easy to offer now.
  • #23: We have people who desperately want to be involved with OpenStack – get led to docs, but have no idea how to write or make images or…When you want something done, ask a busy person. Unless the busy person just answers email all day.
  • #25: Comments are going great, now users answer each other. I did a content audit, does a community audit also make sense? We are seeing some dilution though with too many sites such as a new forums site and Launchpad Answers also vying for attention.
  • #26: Also thinking about a tweet chat – gets out of the IRC mold which might work well for a good portion of our users
  • #28: Curated search engine plus search analyticsWorking on loyalty, bounce rateProof of the PDF popularity
  • #31: We came out of the gate with way too many topics out there. We quickly learned that with too many topics and not enough interaction to start, it made the community seem empty. It’s what I call ‘empty restaurant syndrome’ — if you look in a window and no one is in there, you likely won’t go in.– Mike HardyStrategic communications program managerPitney-Bowes
  • #33: Next – Launch and Learn
  • #34: I plan to keep iterating, keep prioritizing, keep having fun, and keep learning. Join me!