crowdsourcing your documentation: managing a crowdsourced documentation project

44
Crowdsourcing your documentation Managing a crowdsourced documentation project [email protected] | twitter: @subege Susan Griffin • Training Program Manager • Atlassian

Upload: susan-griffin

Post on 15-Jul-2015

774 views

Category:

Technology


0 download

TRANSCRIPT

Page 1: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Crowdsourcing your documentation Ma n ag i n g a c rowd sou rce d d o cu m e n t at i o n p ro j e c t

s g r i f f i n @ a t l a s s i a n . c o m | t w i t t e r : @ s u b e g e

S u s a n G r i f f i n • T r a i n i n g P r o g r a m M a n a g e r • A t l a s s i a n

Page 2: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Benjamin Franklin

By failing to prepare, you are preparing to fail.

Page 3: Crowdsourcing your documentation: Managing a crowdsourced documentation project

About me •  Technical communicator 25+ years

•  Traditional and non-traditional roles

•  “Never say never”

Interesting fact: This is my third visit to Germany in 12 months. I think it’s time for me to learn to speak German!

Page 4: Crowdsourcing your documentation: Managing a crowdsourced documentation project

What if… Your manager came to you and said:

We are opening a new Support office in Austin, Texas, in four months and we need a brand new training program by the time that office opens.

We can’t give you a writer, but you can use some of the Senior Support Engineers in our other offices to help you create the program.

Don’t forget to breathe.*

(*someone actually said that to me)

We want this training program to be used by the 60+ new hires we plan on adding in Austin by the end of this year, and it needs to include a 30-day induction plan.

Page 5: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 6: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 7: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 8: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Collaborative workforce or intelligence

How many of you have heard of…

•  Coordinated crowd activities

•  Open innovation

•  Social collaboration

Page 9: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Jeff Howe, Wired magazine, 2006

“Simply defined, crowdsourcing represents the act of a company or institution taking a function once performed by employees and outsourcing it to an undefined (and generally large) network of people in the form of an open call.”

Page 10: Crowdsourcing your documentation: Managing a crowdsourced documentation project

However…

Page 11: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Figure out who your experts are

Keeping this in mind

•  Create a core team, with a mission statement

•  Set up weekly, even biweekly, meetings

•  Communicate through all available channels

•  Have a clearly defined road map and goals

Page 12: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Factor in the geographical differences

Figure out who your experts are

•  If one expert doesn’t know something, find another who does

•  Get buy-in from everyone’s manager

Page 13: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Mission Statement:

The GSD team will review, update, and comment wrangle the Support procedural information that forms one part of Support Training Program. Our goal is to complete this work by the Austin site launch, or APRIL 8, 2014.

The Get Stuff Done Team

Page 14: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Review the documentation and provide feedback to other members of this team by the requested date.

Set expectations

•  Attend weekly meetings.

•  Provide feedback in comments in the restricted site.

•  Monitor and respond to comments from the rest of Support.

Page 15: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 16: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Even if the path changes, know where you are going.

Road map and clear goals

•  Know the sacrifices you are willing to make…

•  And the ones that cannot be made.

Page 17: Crowdsourcing your documentation: Managing a crowdsourced documentation project

At the beginning…

Page 18: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Hundreds of pages of Support training materials spread out across all of EAC and several other systems.

•  No one knows where everything is, content is created and abandoned. Duplicate content exists everywhere.

•  The content organization isn’t apparent, making it hard to find things.

•  Each time we have a new starter, team leads need to create a training schedule. No one uses anything approaching the same format.

•  We are in a constant state of “reinventing” the training materials, which is time-consuming and frustrating for everyone.

The current state of play*

* Data from about 60 hours of informational interviews with individuals across the C4L team.

Page 19: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Everyone understands “The Code of Legendary Service” and knows what this means when they interact with customers.

•  Day-to-day business procedures are the same across all Geos (or as close as possible, and we start from the same baseline procedure).

•  New starters are able to get up to speed within 90 days and understand the “how and why” of our products and tools.

•  The training materials are professionally written, consistent, and regularly updated.

•  We create a standard that other departments want to follow.

We want a program where:

Page 20: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  One space to rule them all: Support Training content lives in one place on EAC.

•  We provide information on the three pillars of Atlassian Support:

•  Philosophy/Values (our code of service).

•  Procedures: how to do your job.

•  Technical training: we are consumers of the great content coming from Sherry’s team as well as content we create.

•  Our materials are well written, consistent, and regularly updated.

What does this look like?

Page 21: Crowdsourcing your documentation: Managing a crowdsourced documentation project

How does this help the business? Over time, we should see the following:

•  New hires come up to speed quicker (goal: half the time it takes currently, or 90 days).

•  We can expand Support faster if we reduce the amount of time a TL can expect to spend one-on-one with new hires.

•  We have more expertise spread across the business.

•  We have everyone speaking the same language and operating in the same ways, so our customers get a consistently good experience.

Page 22: Crowdsourcing your documentation: Managing a crowdsourced documentation project

How do we accomplish this? •  Engage all key stakeholders across the team (started Dec

2013)

•  Evaluate current materials (in progress)

•  Form a small, core group of senior support staff to review and update procedures (starts this week)

•  Outline what can be accomplished, by when (this presentation)

•  Create a timeline (next slide)

Page 23: Crowdsourcing your documentation: Managing a crowdsourced documentation project

GETTING STARTED

•  Susan •  Rick •  Michael A. •  EMEA (TBD)

DATA GATHERING

•  Susan

ONBOARDING

•  Susan •  Ning

The road ahead, part one

DOC REVIEW (Support Induction)

•  Susan •  Rick •  Michael A. •  EMEA (TBD) •  KL leads •  Tim •  Daniel R. •  Others as needed

DEC 13 – FEB 14 JAN – MAR 14 MAR – MAY 14 JAN – MAY 14

6 weeks so far, another

6 weeks needed

The GSD* team

Various SMEs

Yet to be scoped

* My senior support engineer advisory committee

Page 24: Crowdsourcing your documentation: Managing a crowdsourced documentation project

TECHNICAL FOUNDATION

•  Susan •  Tim

LEGENDARY SERVICE

•  Susan •  Partha •  Jim C.

DOC CREATION

•  Susan •  Writer (TBH)

The road ahead, part two

PRODUCT TRAINING

•  Susan •  Sherry & team •  Writer (TBH)

JAN – MAR 14 JAN – MAR 14 MAR – ONGOING 14 JAN – MAY 14

Partha to outline

objectives to Jim

Courses coming

starting in Feb

List of docs to create will come

out of GSD In progress

Page 25: Crowdsourcing your documentation: Managing a crowdsourced documentation project

What can be delivered by April 1

TECHNICAL FOUNDATION Susan/Tim Updates to existing content only.

NEW SUPPORT TRAINING SITE*

Susan Make site live, move content over. Stuff will break during this time.

PRODUCT TRAINING

Sherry’s team JIRA Essentials JIRA Agile in Practice JIRA/Confluence Integration JIRA Admin Getting Started with Confluence Getting Started with Git and Stash

MAR – APR 14 MAR – APR 14 FEB – APR 14

Assuming 100% of Susan’s time, some portion of the GSD team’s time, as well as some of Ning’s time.

Page 26: Crowdsourcing your documentation: Managing a crowdsourced documentation project

How I kept track

Page 27: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 28: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Use what you know and are comfortable with, but…

•  If others can contribute as well, that will make your job easier.

•  Don’t be afraid to try something new! You might discover a tool that works better for you.

Project tracking tools

Page 29: Crowdsourcing your documentation: Managing a crowdsourced documentation project

My project tracker

Page 30: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Project workflow

Page 31: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Issue example

Page 32: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Have a meeting schedule and stick to it.

Find communication that works

•  Hold people accountable for deliverables.

•  Sometimes you won’t be popular.

Page 33: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Communication/Collaboration tools

Page 34: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Blogs

Spread the word

•  Forums

•  Any other internal means of communicating to a wide audience

Page 35: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 36: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 37: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 38: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Ongoing Maintenance

Page 39: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  New projects need new owners

Post-Launch Activities

•  The challenge of the remote team

•  Assessing progress and making changes

Page 40: Crowdsourcing your documentation: Managing a crowdsourced documentation project
Page 41: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Juggling time zones isn’t easy

Page 42: Crowdsourcing your documentation: Managing a crowdsourced documentation project

•  Survey feedback

How do you measure success?

•  Changes in NPS (net promoter score) and/or KPI (key performance indicator)

•  Test scores

Page 43: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Thank you!

S u s a n G r i f f i n • T r a i n i n g P r o g r a m M a n a g e r • A t l a s s i a n

s g r i f f i n @ a t l a s s i a n . c o m | t w i t t e r : @ s u b e g e

Page 44: Crowdsourcing your documentation: Managing a crowdsourced documentation project

Your opinion is important to us! Please tell us what you thought of the lecture. We look forward to your feedback via smartphone or tablet under

http://TA6.honestly.de or scan the QR code    

The feedback tool will be available even after the conference!