The Rocky Road to DITA

45
The Rocky Road to Dublin flickr: ro-silva, Cliffs of Moher Toni Mantych, ADP, and Sarah O’Keefe, Scriptorium The Rocky Road to DITA

Transcript of The Rocky Road to DITA

Page 1: The Rocky Road to DITA

TheRockyRoadtoDublinflickr: ro-silva, Cliffs of Moher

Toni Mantych, ADP, and Sarah O’Keefe, Scriptorium

TheRockyRoadtoDITA

Page 2: The Rocky Road to DITA

Aboutthepresenters

@tonimantych @sarahokeefe #rockyDITAflickr: Buddha Dog. Portola Valley, California, USA

Page 3: The Rocky Road to DITA

@tonimantych @sarahokeefe #rockyDITA

ToniMantych,@tonimantych❖ Information Architect, ADP

SarahO’Keefe,@sarahokeefe❖ Founder and President, Scriptorium

Page 4: The Rocky Road to DITA

DITAImplementationTherapySession

Toni Mantych, ADP, and Sarah O’Keefe, ScriptoriumDRAFT

Page 5: The Rocky Road to DITA

Questions,please!

❖ Fill out an index card and pass it up.

❖ Use the #rockyDITA hashtag on Twitter.

❖ Use the microphone.

@tonimantych @sarahokeefe #rockyDITAflickr: Buddha Dog. Caves Cove, Tennessee, USA

Page 6: The Rocky Road to DITA

ADPprojectoverview

@tonimantych @sarahokeefe #rockyDITAflickr: Eva Luedin

Page 7: The Rocky Road to DITA

ADPprojectoverview

❖ 60 writers

❖ Mostly RoboHelp

❖ Implementing DITA, CCMS, topic-based writing

❖ Business case: Localization, reuse, and quality

❖ The business case was easy.

@tonimantych @sarahokeefe #rockyDITA

Page 8: The Rocky Road to DITA

Weexpectedsmoothsailing.

@tonimantych @sarahokeefe #rockyDITAflickr: zoomzoom

Page 9: The Rocky Road to DITA

Maybeafewsmallsurprises…

@tonimantych @sarahokeefe #rockyDITAflickr: amardilo

Page 10: The Rocky Road to DITA

Butinstead…

@tonimantych @sarahokeefe #rockyDITAflickr: joiseyshowaa, Bangladesh

Page 11: The Rocky Road to DITA

Whatmadetheroadrocky?(“Agenda”)

❖ Complex conditions

❖ Resource constraints

❖ The matrix: Influence without authority

❖ Building skills

@tonimantych @sarahokeefe #rockyDITA

Page 12: The Rocky Road to DITA

Complexconditions

@tonimantych @sarahokeefe #rockyDITAflickr: shannonpatrick17,Houston, Texas

Page 13: The Rocky Road to DITA

Complexconditions

❖ So. Many. Meetings.

@tonimantych @sarahokeefe #rockyDITA

Page 14: The Rocky Road to DITA

Graphicshelped.Somewhat.

@tonimantych @sarahokeefe #rockyDITA

Page 15: The Rocky Road to DITA

Balanceandfocus

❖ Value of reuse

❖ Complexity of conditionals

@tonimantych @sarahokeefe #rockyDITA

Page 16: The Rocky Road to DITA

Don’tfocusonlyonmaximizingreuse.

Complexity is expensive.

@tonimantych @sarahokeefe #rockyDITA

dangerousroads.org, Swindon, UK

Page 17: The Rocky Road to DITA

Wehadresourceconstraints.

@tonimantych @sarahokeefe #rockyDITAflickr: infomatique, Ormond Quay area, Dublin

Page 18: The Rocky Road to DITA

Wehadresourceconstraints.

❖ Not enough people.

❖ Not enough funding.

@tonimantych @sarahokeefe #rockyDITAflickr: infomatique, Ormond Quay area, Dublin

Page 19: The Rocky Road to DITA

Addressingresourceconstraints

❖ Hire consultants for expertise and quick wins to build momentum

❖ But focus on building knowledge internally

@tonimantych @sarahokeefe #rockyDITAflickr: infomatique, Ormond Quay area, Dublin

Page 20: The Rocky Road to DITA

Whattodoaboutlackofexperience?

@tonimantych @sarahokeefe #rockyDITAflickr: deepakkt, Chinnakallar Falls, Valparai, India

Page 21: The Rocky Road to DITA

Whattodoaboutlackofexperience?

❖ Use consultants wisely

❖ Start learning early

❖ Build your team with care

❖ Plan your project to accommodate learning

@tonimantych @sarahokeefe #rockyDITA

Page 22: The Rocky Road to DITA

Theconsultantparadox

❖ Expertise = quick wins and momentum

❖ Overreliance = Can’t manage project internally

@tonimantych @sarahokeefe #rockyDITAflickr: barelyfitz

Page 23: The Rocky Road to DITA

Bustthroughtheparadox.

@tonimantych @sarahokeefe #rockyDITAflickr: urbanwoodchuck, Tennessee?

Page 24: The Rocky Road to DITA

Useconsultantsproperly

❖ Hire consultants for expert knowledge at project start

❖ Get quick wins to build momentum

❖ Insist on knowledge transfer

❖ Grow team expertise over time

@tonimantych @sarahokeefe #rockyDITAflickr: urbanwoodchuck, Tennessee?

Page 25: The Rocky Road to DITA

Withoutknowledgetransfer,youaren’taclient,you’reahostage.

@tonimantych @sarahokeefe #rockyDITAflickr: Yellowstone National Park

Page 26: The Rocky Road to DITA

Projectexpertise

@tonimantych @sarahokeefe #rockyDITA

Project start Pilot Implementation Maintenance

Consultants Staff

Page 27: The Rocky Road to DITA

@tonimantych @sarahokeefe #rockyDITA

External Internal

Consultants Staff

Page 28: The Rocky Road to DITA

Startlearningearly

❖ Informal DITA knowledge acquisition (LearningDITA.com and others)

❖ Read

❖ Attend conferences and learn from others’ mistakes (like right now!!)

@tonimantych @sarahokeefe #rockyDITA

Page 29: The Rocky Road to DITA

Buildyourteamwithcare

@tonimantych @sarahokeefe #rockyDITAflickr: North Dakota Department of Transportation

Page 30: The Rocky Road to DITA

Buildyourteamwithcare

❖ Early adopters

❖ Thrive on learning independently

❖ Build esprit de corps

@tonimantych @sarahokeefe #rockyDITA

Page 31: The Rocky Road to DITA

Howtobuildtheteam

@tonimantych @sarahokeefe #rockyDITAflickr: junaelo242a, Chile

Page 32: The Rocky Road to DITA

Howtobuildtheteam

❖ Diverse skills and attitudes

❖ Continuous learning

❖ Very different from core job

❖ Requires trial and error

❖ Risk perception varies

@tonimantych @sarahokeefe #rockyDITA

Page 33: The Rocky Road to DITA

Accommodatelearning

@tonimantych @sarahokeefe #rockyDITAflickr: Jerald Jackson, Spring, Texas, USA

Page 34: The Rocky Road to DITA

Accommodatelearning

❖ Give early adopters small, low-risk projects

❖ Make mistakes early

❖ Understand that some people like uncertainty and others fear uncertainty

@tonimantych @sarahokeefe #rockyDITA

Page 35: The Rocky Road to DITA

Intothematrix

@tonimantych @sarahokeefe #rockyDITA

flickr: robertpaulyoung. Giant’s Causeway

Page 36: The Rocky Road to DITA

Intothematrix(organization)

❖ Inexperienced matrix team

❖ No in-house experience is the standard

❖ New hires won’t solve the problem because they have no social capital

❖ Best case is someone who by coincidence had previous experience

@tonimantych @sarahokeefe #rockyDITA

Page 37: The Rocky Road to DITA

Matrixmanagement

❖ Clearly define roles, responsibilities, expectations

❖ Accountability

❖ Establish a communication strategy

❖ Pre-arrange a method for dealing with conflicts

@tonimantych @sarahokeefe #rockyDITA

Page 38: The Rocky Road to DITA

Learning

@tonimantych @sarahokeefe #rockyDITAflickr: dennyarmstrong. Mogolion, New Mexico, USA

Page 39: The Rocky Road to DITA

Mapfrom“oldway”to“newway”

@tonimantych @sarahokeefe #rockyDITA

Page 40: The Rocky Road to DITA

Learning

❖ Train early and often

❖ Uncover issues with the implementation

❖ Discover unmet needs

❖ Use collaboration systems

❖ Tip page with list of shortcuts

❖ Best practices from experience

@tonimantych @sarahokeefe #rockyDITA

Page 41: The Rocky Road to DITA

Howtostayontrack

@tonimantych @sarahokeefe #rockyDITA

flick

r: ex

plor

e_ph

otog

raph

y

Page 42: The Rocky Road to DITA

Real-lifeprojectmanagement

@tonimantych @sarahokeefe #rockyDITA

Gra

phic

: Gre

tyl K

inse

y

Page 43: The Rocky Road to DITA

Prerequisitesversuslearningduringtheproject

@tonimantych @sarahokeefe #rockyDITAflickr: ro-silva. Giant’s Causeway

Page 44: The Rocky Road to DITA

Prerequisitesversuslearningduringtheproject

❖ Flexibility

❖ Willingness to learn

❖ Perseverance

❖ Motivation

❖ We can teach the rest, but only if the person wants to learn

@tonimantych @sarahokeefe #rockyDITA

Page 45: The Rocky Road to DITA

Questions?

@tonimantych @sarahokeefe #rockyDITAflickr: alexranaldi, Cliffs of Moher