SlideShare a Scribd company logo
1 of 20
Download to read offline
Making the Mental Shift to
Topic-based Authoring and
Content Management

Leigh White
DITA Specialist

Lavacon
October 2013
This is really a presentation about

2
Change is inevitable…

Managing change is not

3
If you don’t manage change…

It will manage you

4
Who are you?
• The person responsible for planning and carrying out
a TBSA* implementation





Manager
Team lead
Information architect
?

*Topic-based, structured authoring. I will probably slip and say
“DITA” but that’s not the only TBSA framework.

5
What have you already done?
• Exhaustively researched TBSA
• Developed a solid business case
• Sold it to the higher-ups
• Gotten buy-in at all levels above you

6
And now, the rollout…

The rollout sets the tone for the whole project
7
Have a plan
• Before you present TBSA to the team, cover all your
bases
 Anticipate every question and opposition
 Be able to communicate exactly what will happen, when,
and who will be responsible:
• Training
• Tool selection (XML editor, CMS, etc.)*
• Information architecture
• Output styling******
• Legacy content conversion
• Collaboration among authors*
• Governance***

* These will be HUGE areas of discussion!
8
Be honest
• The learning curve will be steep
• There will be extra work in the short term
 Learning principles of TBSA
 Learning tools
 Content conversion
PLUS
 Ongoing work
 Maybe duplicate content maintenance for a while

• Be honest about what will change
 Not just a move from one tool to another
• Completely different approach to writing

 No control over formatting and outputs
 No more Lone Rangers…writers must collaborate and follow
same styles and guidelines

9
Be honest (2)
• Be very specific about the rewards
 Articulate the team’s pain points & note the solution
• Errors & inconsistencies in documentation
• Frantic scrambling near deadlines
• Duplicate content in different formats
• Inconsistent toolsets and processes

 Articulate the company’s pain points
• Customer complaints
• Rising support costs
• Ability to deliver innovative solutions limited by ability to

provider user assistance

 Base rewards discussion on the research you did to justify

the move to TBSA in the first place.
 If you can’t be specific about the rewards, you’re not ready
to implement TBSA.
10
Don’t get sidetracked by naysayers
• Address their general concerns
• But don’t get led down the garden path
 “So we can’t have tables with the 3rd column of every 5th

row shaded and a dotted line after rows that start with the
letter G? Our clients really expect that. They’ll complain if
we can’t do it.”

• Stress that all conventions, especially styling
conventions, are up for reevaluation
 Everything is on the table.
 They must be prepared to offer solid justification for their
wants.
 “We’ve always done it that way” is not solid justification.

11
Enthusiasm is not necessarily contagious
• Even though you explain the problems and how
TBSA will solve those problems, many people will
still be unconvinced
 Don’t let the resistance take you by surprise
• Is this the best solution?
• What other solutions can we look at?

 Don’t get exasperated
• Lots of uncertainty and doubt associated with change
• Can I learn to do this?
• Increased efficiency = staff reduction?

12
Talk to individuals
• Completely open discussion
• Get to the root of resistance
 It might not be about the current situation at all
• Previous negative experience
• Ongoing life events

• Set individual expectations and measurements





How will their work and responsibilities change?
What is expected of them during and after the change?
How they will be measured?
What will success or failure mean for them and the team?

13
Talk to individuals (2)
• Everybody comes at change from a different
viewpoint:
 Dejuan is a writer who works on a very small, simple product with

only two releases a year and only one type of documentation.
 Sally is a writer who works on a very large, complex product with
3 other writers. There are 4 major releases, and dozens of
patches/hotfixes a year. There are online help, user guides, and
quick reference guides, each with several variations, that have to
be produced for each release.
 Manish is an editor who reviews the documentation, usually in PDF
format, for typographical accuracy and adherence to style
standards.
 Nadia is an SME who contributes content, usually in Word.

• Frame discussions in each person’s individual
context
 No one-size-fits-all approach
14
Create ownership
• Identify key people and let them help you
 Every team has natural leaders outside management …

people other writers naturally look up to. Involve them at
the earliest practical stage and get them to help you plan.
 Have them lead teams as mentors or representatives so
that decisions (where practical) are made collaboratively
from within the ranks instead of coming down from “on
high.”

15
Keep an open mind and stay flexible
• Expect the unexpected
 Things will come up that you didn’t and couldn’t have
anticipated.

• Personnel changes
• Company reorgs/change of focus
• Resistance in unexpected areas
• Unexpected technical challenges

• If the plan needs to change, change it
 Be clear with the team about why.
 If it was something you overlooked, don’t try to fake people
out – (that honesty thing again).

16
To sum up
• Make sure your implementation plan is complete
 Not necessarily every detail but sufficient to reassure the

team that the pieces are in place and all important issues
have been considered and accounted for

• Be honest with the team
 State the challenges up front. Don't whitewash. Be clear

about the extent of the effort and its effects on everyone.
Be honest about the effects on day-to-day work both in the
short and long term.

• Don’t get sidetracked
 Resist the urge to reassure writers on every minute detail.
This can turn into a sparring contest.

• Don't be surprised by resistance
 Just explaining the problem and showing the solution is not
enough to sell the plan.

17
To sum up (2)
• Have individual discussions
 Frame the change in the context of each writer's

responsibilities, experience level, concerns, questions.

• Create ownership
 Spread responsibility for certain decisions and processes
among key players on the team, not just management.

• Keep an open mind and stay flexible
 Be prepared to change the plan to fit changing
circumstances.

18
QUESTIONS?

19
Available in the
Lavacon bookstore
and from Amazon

leigh.white@ixiasoft.com

CONTACT ME

20

More Related Content

What's hot

Co-Developing and Implementing a Content Strategy Focued on User Experience R...
Co-Developing and Implementing a Content Strategy Focued on User Experience R...Co-Developing and Implementing a Content Strategy Focued on User Experience R...
Co-Developing and Implementing a Content Strategy Focued on User Experience R...LavaCon
 
Ecomagination writer's style guide
Ecomagination writer's style guideEcomagination writer's style guide
Ecomagination writer's style guideMelinda Belcher
 
Better governance, better workflows
Better governance, better workflowsBetter governance, better workflows
Better governance, better workflowsAhava Leibtag
 
Content Strategy: Adobe Day at LavaCon 2019
Content Strategy: Adobe Day at LavaCon 2019Content Strategy: Adobe Day at LavaCon 2019
Content Strategy: Adobe Day at LavaCon 2019Publishing Smarter
 
Proposals - What to Say, How to Say It, and How Much to Charge
Proposals - What to Say, How to Say It, and How Much to Charge Proposals - What to Say, How to Say It, and How Much to Charge
Proposals - What to Say, How to Say It, and How Much to Charge STC-Philadelphia Metro Chapter
 
Blend Well for Best Results - Optimizing Engineer and Tech Writer Collaboration
Blend Well for Best Results - Optimizing Engineer and Tech Writer CollaborationBlend Well for Best Results - Optimizing Engineer and Tech Writer Collaboration
Blend Well for Best Results - Optimizing Engineer and Tech Writer CollaborationJody Zolli
 
[Case Study] Adopting an Agile Content Development Process with Debra Brinson...
[Case Study] Adopting an Agile Content Development Process with Debra Brinson...[Case Study] Adopting an Agile Content Development Process with Debra Brinson...
[Case Study] Adopting an Agile Content Development Process with Debra Brinson...Information Development World
 
Lessons Learned... Migration to DITA During Corporate Acquisitions
Lessons Learned... Migration to DITA During Corporate AcquisitionsLessons Learned... Migration to DITA During Corporate Acquisitions
Lessons Learned... Migration to DITA During Corporate AcquisitionsPublishing Smarter
 
From Zero to DITA in about 60 Minutes
From Zero to DITA in about 60 MinutesFrom Zero to DITA in about 60 Minutes
From Zero to DITA in about 60 MinutesPublishing Smarter
 
10 Ways DITA Can Help Drive a Unified Strategy
10 Ways DITA Can Help Drive a Unified Strategy10 Ways DITA Can Help Drive a Unified Strategy
10 Ways DITA Can Help Drive a Unified StrategyPublishing Smarter
 
Global Content Strategy: Don't Get Lost in Translation
Global Content Strategy: Don't Get Lost in TranslationGlobal Content Strategy: Don't Get Lost in Translation
Global Content Strategy: Don't Get Lost in TranslationMelinda Belcher
 
Agile Content Strategy: Tips and Tricks
Agile Content Strategy: Tips and TricksAgile Content Strategy: Tips and Tricks
Agile Content Strategy: Tips and TricksMelinda Belcher
 
How to Extend Your Content Marketing Plan to a Global Audience
How to Extend Your Content Marketing Plan to a Global AudienceHow to Extend Your Content Marketing Plan to a Global Audience
How to Extend Your Content Marketing Plan to a Global AudienceSDL
 
Barry saiff - Outsourcing Technical Writing a forum
Barry saiff - Outsourcing Technical Writing a forumBarry saiff - Outsourcing Technical Writing a forum
Barry saiff - Outsourcing Technical Writing a forumLavaConConference
 
Educate 2017: Inclusivity Means Opportunity: Why accessibility is a priority
Educate 2017: Inclusivity Means Opportunity: Why accessibility is a priorityEducate 2017: Inclusivity Means Opportunity: Why accessibility is a priority
Educate 2017: Inclusivity Means Opportunity: Why accessibility is a priorityLearnosity
 
Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...
Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...
Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...SDL
 
Leading Your Business Customer
Leading Your Business Customer Leading Your Business Customer
Leading Your Business Customer Dean Stevens
 
Successful writing at work copyright 2017 cengage learn
Successful writing at work copyright 2017 cengage learnSuccessful writing at work copyright 2017 cengage learn
Successful writing at work copyright 2017 cengage learnssusere73ce3
 
DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...
DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...
DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...Publishing Smarter
 

What's hot (20)

Co-Developing and Implementing a Content Strategy Focued on User Experience R...
Co-Developing and Implementing a Content Strategy Focued on User Experience R...Co-Developing and Implementing a Content Strategy Focued on User Experience R...
Co-Developing and Implementing a Content Strategy Focued on User Experience R...
 
Ecomagination writer's style guide
Ecomagination writer's style guideEcomagination writer's style guide
Ecomagination writer's style guide
 
Better governance, better workflows
Better governance, better workflowsBetter governance, better workflows
Better governance, better workflows
 
Content Strategy: Adobe Day at LavaCon 2019
Content Strategy: Adobe Day at LavaCon 2019Content Strategy: Adobe Day at LavaCon 2019
Content Strategy: Adobe Day at LavaCon 2019
 
Proposals - What to Say, How to Say It, and How Much to Charge
Proposals - What to Say, How to Say It, and How Much to Charge Proposals - What to Say, How to Say It, and How Much to Charge
Proposals - What to Say, How to Say It, and How Much to Charge
 
Blend Well for Best Results - Optimizing Engineer and Tech Writer Collaboration
Blend Well for Best Results - Optimizing Engineer and Tech Writer CollaborationBlend Well for Best Results - Optimizing Engineer and Tech Writer Collaboration
Blend Well for Best Results - Optimizing Engineer and Tech Writer Collaboration
 
[Case Study] Adopting an Agile Content Development Process with Debra Brinson...
[Case Study] Adopting an Agile Content Development Process with Debra Brinson...[Case Study] Adopting an Agile Content Development Process with Debra Brinson...
[Case Study] Adopting an Agile Content Development Process with Debra Brinson...
 
Lessons Learned... Migration to DITA During Corporate Acquisitions
Lessons Learned... Migration to DITA During Corporate AcquisitionsLessons Learned... Migration to DITA During Corporate Acquisitions
Lessons Learned... Migration to DITA During Corporate Acquisitions
 
From Zero to DITA in about 60 Minutes
From Zero to DITA in about 60 MinutesFrom Zero to DITA in about 60 Minutes
From Zero to DITA in about 60 Minutes
 
10 Ways DITA Can Help Drive a Unified Strategy
10 Ways DITA Can Help Drive a Unified Strategy10 Ways DITA Can Help Drive a Unified Strategy
10 Ways DITA Can Help Drive a Unified Strategy
 
Global Content Strategy: Don't Get Lost in Translation
Global Content Strategy: Don't Get Lost in TranslationGlobal Content Strategy: Don't Get Lost in Translation
Global Content Strategy: Don't Get Lost in Translation
 
Agile Content Strategy: Tips and Tricks
Agile Content Strategy: Tips and TricksAgile Content Strategy: Tips and Tricks
Agile Content Strategy: Tips and Tricks
 
How to Extend Your Content Marketing Plan to a Global Audience
How to Extend Your Content Marketing Plan to a Global AudienceHow to Extend Your Content Marketing Plan to a Global Audience
How to Extend Your Content Marketing Plan to a Global Audience
 
Barry saiff - Outsourcing Technical Writing a forum
Barry saiff - Outsourcing Technical Writing a forumBarry saiff - Outsourcing Technical Writing a forum
Barry saiff - Outsourcing Technical Writing a forum
 
Educate 2017: Inclusivity Means Opportunity: Why accessibility is a priority
Educate 2017: Inclusivity Means Opportunity: Why accessibility is a priorityEducate 2017: Inclusivity Means Opportunity: Why accessibility is a priority
Educate 2017: Inclusivity Means Opportunity: Why accessibility is a priority
 
Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...
Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...
Beyond Globalization: Achieving Universal Understanding - Adolfo Hernandez at...
 
Leading Your Business Customer
Leading Your Business Customer Leading Your Business Customer
Leading Your Business Customer
 
Successful writing at work copyright 2017 cengage learn
Successful writing at work copyright 2017 cengage learnSuccessful writing at work copyright 2017 cengage learn
Successful writing at work copyright 2017 cengage learn
 
A Rapid e-Learning Primer for Technical Communicators
A Rapid e-Learning Primer for Technical CommunicatorsA Rapid e-Learning Primer for Technical Communicators
A Rapid e-Learning Primer for Technical Communicators
 
DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...
DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...
DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...
 

Viewers also liked

LavaCon - Content Strategy and Brand Personalities
LavaCon - Content Strategy and Brand PersonalitiesLavaCon - Content Strategy and Brand Personalities
LavaCon - Content Strategy and Brand PersonalitiesMarli Mesibov
 
Accessibility in video production
Accessibility in video productionAccessibility in video production
Accessibility in video productionKen Circeo
 
Content Marketing: Pulling your content out from under the bushel basket
Content Marketing: Pulling your content out from under the bushel basketContent Marketing: Pulling your content out from under the bushel basket
Content Marketing: Pulling your content out from under the bushel basketMatt Sullivan
 
Case Study: Serving Authors' Needs in a Brave New DITA World
Case Study: Serving Authors' Needs in a Brave New DITA WorldCase Study: Serving Authors' Needs in a Brave New DITA World
Case Study: Serving Authors' Needs in a Brave New DITA WorldJulie Atkins
 
Generating Insights: Using Competitive Assessment to Shape Your Content Strategy
Generating Insights: Using Competitive Assessment to Shape Your Content StrategyGenerating Insights: Using Competitive Assessment to Shape Your Content Strategy
Generating Insights: Using Competitive Assessment to Shape Your Content StrategyLaura Blaydon
 
10 mistakes when you move to topic-based authoring
10 mistakes when you move to topic-based authoring10 mistakes when you move to topic-based authoring
10 mistakes when you move to topic-based authoringSharon Burton
 

Viewers also liked (6)

LavaCon - Content Strategy and Brand Personalities
LavaCon - Content Strategy and Brand PersonalitiesLavaCon - Content Strategy and Brand Personalities
LavaCon - Content Strategy and Brand Personalities
 
Accessibility in video production
Accessibility in video productionAccessibility in video production
Accessibility in video production
 
Content Marketing: Pulling your content out from under the bushel basket
Content Marketing: Pulling your content out from under the bushel basketContent Marketing: Pulling your content out from under the bushel basket
Content Marketing: Pulling your content out from under the bushel basket
 
Case Study: Serving Authors' Needs in a Brave New DITA World
Case Study: Serving Authors' Needs in a Brave New DITA WorldCase Study: Serving Authors' Needs in a Brave New DITA World
Case Study: Serving Authors' Needs in a Brave New DITA World
 
Generating Insights: Using Competitive Assessment to Shape Your Content Strategy
Generating Insights: Using Competitive Assessment to Shape Your Content StrategyGenerating Insights: Using Competitive Assessment to Shape Your Content Strategy
Generating Insights: Using Competitive Assessment to Shape Your Content Strategy
 
10 mistakes when you move to topic-based authoring
10 mistakes when you move to topic-based authoring10 mistakes when you move to topic-based authoring
10 mistakes when you move to topic-based authoring
 

Similar to Making The Mental Shift to Topic-Based Authoring

Making the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMSMaking the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMSLeigh White
 
Making the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMSMaking the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMSIXIASOFT
 
Project Management in the Real World
Project Management in the Real WorldProject Management in the Real World
Project Management in the Real WorldKate Daly
 
Implementing Licensing— A Journey
Implementing Licensing— A JourneyImplementing Licensing— A Journey
Implementing Licensing— A JourneyFlexera
 
Agile Topics - Explained Simply - Practical Agilist.pptx
Agile Topics - Explained Simply - Practical Agilist.pptxAgile Topics - Explained Simply - Practical Agilist.pptx
Agile Topics - Explained Simply - Practical Agilist.pptxBrian Link
 
The art and craft of writing successful proposals
The art and craft of writing successful proposalsThe art and craft of writing successful proposals
The art and craft of writing successful proposalsAmjad Idries
 
10 Mistakes When Moving to Topic-Based Authoring
10 Mistakes When Moving to Topic-Based Authoring10 Mistakes When Moving to Topic-Based Authoring
10 Mistakes When Moving to Topic-Based Authoringdclsocialmedia
 
Scrum; Conflict solving method
Scrum; Conflict solving methodScrum; Conflict solving method
Scrum; Conflict solving methodMD. Saraf Uddin
 
15 Lessons from 15 Years in the Industry
15 Lessons from 15 Years in the Industry15 Lessons from 15 Years in the Industry
15 Lessons from 15 Years in the IndustryStefan Freimark
 
Innovating in the social space
Innovating in the social spaceInnovating in the social space
Innovating in the social spaceRobin Low
 
Laurens Bonnema: The Agile Project Management Bootcamp Taster
Laurens Bonnema: The Agile Project Management Bootcamp TasterLaurens Bonnema: The Agile Project Management Bootcamp Taster
Laurens Bonnema: The Agile Project Management Bootcamp TasterLviv Startup Club
 
PXT Select™ Individual’s Feedback Report sample
PXT Select™ Individual’s Feedback Report samplePXT Select™ Individual’s Feedback Report sample
PXT Select™ Individual’s Feedback Report sampleTalentGear.com
 
Running Support For A Premium WordPress Plugin
Running Support For A Premium WordPress PluginRunning Support For A Premium WordPress Plugin
Running Support For A Premium WordPress Pluginroblagatta
 
Be a great product leader by Adam Nash, VP Product, Dropbox
Be a great product leader by Adam Nash, VP Product, DropboxBe a great product leader by Adam Nash, VP Product, Dropbox
Be a great product leader by Adam Nash, VP Product, DropboxAmplitude
 

Similar to Making The Mental Shift to Topic-Based Authoring (20)

Making the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMSMaking the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMS
 
Making the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMSMaking the Mental Shift to Topic-Based Authoring and a CMS
Making the Mental Shift to Topic-Based Authoring and a CMS
 
Project Management in the Real World
Project Management in the Real WorldProject Management in the Real World
Project Management in the Real World
 
Implementing Licensing— A Journey
Implementing Licensing— A JourneyImplementing Licensing— A Journey
Implementing Licensing— A Journey
 
Agile Topics - Explained Simply - Practical Agilist.pptx
Agile Topics - Explained Simply - Practical Agilist.pptxAgile Topics - Explained Simply - Practical Agilist.pptx
Agile Topics - Explained Simply - Practical Agilist.pptx
 
DevOps Year One
DevOps Year OneDevOps Year One
DevOps Year One
 
The art and craft of writing successful proposals
The art and craft of writing successful proposalsThe art and craft of writing successful proposals
The art and craft of writing successful proposals
 
10 Mistakes When Moving to Topic-Based Authoring
10 Mistakes When Moving to Topic-Based Authoring10 Mistakes When Moving to Topic-Based Authoring
10 Mistakes When Moving to Topic-Based Authoring
 
Scrum; Conflict solving method
Scrum; Conflict solving methodScrum; Conflict solving method
Scrum; Conflict solving method
 
15 Lessons from 15 Years in the Industry
15 Lessons from 15 Years in the Industry15 Lessons from 15 Years in the Industry
15 Lessons from 15 Years in the Industry
 
What is proactive project management?
What is proactive project management?What is proactive project management?
What is proactive project management?
 
Client vs design
Client vs designClient vs design
Client vs design
 
Session 3
Session 3Session 3
Session 3
 
Innovating in the social space
Innovating in the social spaceInnovating in the social space
Innovating in the social space
 
Laurens Bonnema: The Agile Project Management Bootcamp Taster
Laurens Bonnema: The Agile Project Management Bootcamp TasterLaurens Bonnema: The Agile Project Management Bootcamp Taster
Laurens Bonnema: The Agile Project Management Bootcamp Taster
 
Content Conceptial
Content ConceptialContent Conceptial
Content Conceptial
 
PXT Select™ Individual’s Feedback Report sample
PXT Select™ Individual’s Feedback Report samplePXT Select™ Individual’s Feedback Report sample
PXT Select™ Individual’s Feedback Report sample
 
Report writing
Report writing Report writing
Report writing
 
Running Support For A Premium WordPress Plugin
Running Support For A Premium WordPress PluginRunning Support For A Premium WordPress Plugin
Running Support For A Premium WordPress Plugin
 
Be a great product leader by Adam Nash, VP Product, Dropbox
Be a great product leader by Adam Nash, VP Product, DropboxBe a great product leader by Adam Nash, VP Product, Dropbox
Be a great product leader by Adam Nash, VP Product, Dropbox
 

More from Jack Molisani

Negotiation skills the missing ingredient to career success psstc
Negotiation skills the missing ingredient to career success   psstcNegotiation skills the missing ingredient to career success   psstc
Negotiation skills the missing ingredient to career success psstcJack Molisani
 
Honing your workplace negotiating skills
Honing your workplace negotiating skills    Honing your workplace negotiating skills
Honing your workplace negotiating skills Jack Molisani
 
Career advancement through personal branding
Career advancement through personal brandingCareer advancement through personal branding
Career advancement through personal brandingJack Molisani
 
How to ace an interview using a portfolio
How to ace an interview using a portfolio  How to ace an interview using a portfolio
How to ace an interview using a portfolio Jack Molisani
 
The top 10 mistakes professional make when looking for work
The top 10 mistakes professional make when looking for workThe top 10 mistakes professional make when looking for work
The top 10 mistakes professional make when looking for workJack Molisani
 
Resume and job hunting secrets that might surpise you
Resume and job hunting secrets that might surpise youResume and job hunting secrets that might surpise you
Resume and job hunting secrets that might surpise youJack Molisani
 
Negotiation Skills: The Missing Ingredient to Career Success
Negotiation Skills: The Missing Ingredient to Career SuccessNegotiation Skills: The Missing Ingredient to Career Success
Negotiation Skills: The Missing Ingredient to Career SuccessJack Molisani
 
Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...
Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...
Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...Jack Molisani
 
Helen St Denis: How to Prepare your Content for Conversion to DITA
Helen St Denis: How to Prepare your Content for Conversion to DITAHelen St Denis: How to Prepare your Content for Conversion to DITA
Helen St Denis: How to Prepare your Content for Conversion to DITAJack Molisani
 
Les Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEs
Les Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEsLes Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEs
Les Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEsJack Molisani
 
Christpher Ward: What's in a Mission Statement
Christpher Ward: What's in a Mission StatementChristpher Ward: What's in a Mission Statement
Christpher Ward: What's in a Mission StatementJack Molisani
 
Christopher Ward and Bernard Aschwanden: Metrics That Matter
Christopher Ward and Bernard Aschwanden: Metrics That MatterChristopher Ward and Bernard Aschwanden: Metrics That Matter
Christopher Ward and Bernard Aschwanden: Metrics That MatterJack Molisani
 
Lorraine Aochi: Contributions to Help Content
Lorraine Aochi: Contributions to Help ContentLorraine Aochi: Contributions to Help Content
Lorraine Aochi: Contributions to Help ContentJack Molisani
 
Rob Hanna: Leveraging Cognitive Science to Improve Topic- Based Authoring
Rob Hanna: Leveraging Cognitive Science to Improve Topic- Based AuthoringRob Hanna: Leveraging Cognitive Science to Improve Topic- Based Authoring
Rob Hanna: Leveraging Cognitive Science to Improve Topic- Based AuthoringJack Molisani
 
The Future of Learning
The Future of Learning  The Future of Learning
The Future of Learning Jack Molisani
 
Matt Sullivan: Bootstrapping Your Initiatives
Matt Sullivan: Bootstrapping Your InitiativesMatt Sullivan: Bootstrapping Your Initiatives
Matt Sullivan: Bootstrapping Your InitiativesJack Molisani
 
Steve Huffman: You Want It, Now Sell it to Management
Steve Huffman: You Want It, Now Sell it to ManagementSteve Huffman: You Want It, Now Sell it to Management
Steve Huffman: You Want It, Now Sell it to ManagementJack Molisani
 
Andrew Thomas: Frankenstein's Monster
Andrew Thomas: Frankenstein's MonsterAndrew Thomas: Frankenstein's Monster
Andrew Thomas: Frankenstein's MonsterJack Molisani
 
Jeff Engle: Taking the Show on the Road
Jeff Engle: Taking the Show on the RoadJeff Engle: Taking the Show on the Road
Jeff Engle: Taking the Show on the RoadJack Molisani
 
Caroline Juszczak: An Information Development Tent Revival
Caroline Juszczak: An Information Development Tent RevivalCaroline Juszczak: An Information Development Tent Revival
Caroline Juszczak: An Information Development Tent RevivalJack Molisani
 

More from Jack Molisani (20)

Negotiation skills the missing ingredient to career success psstc
Negotiation skills the missing ingredient to career success   psstcNegotiation skills the missing ingredient to career success   psstc
Negotiation skills the missing ingredient to career success psstc
 
Honing your workplace negotiating skills
Honing your workplace negotiating skills    Honing your workplace negotiating skills
Honing your workplace negotiating skills
 
Career advancement through personal branding
Career advancement through personal brandingCareer advancement through personal branding
Career advancement through personal branding
 
How to ace an interview using a portfolio
How to ace an interview using a portfolio  How to ace an interview using a portfolio
How to ace an interview using a portfolio
 
The top 10 mistakes professional make when looking for work
The top 10 mistakes professional make when looking for workThe top 10 mistakes professional make when looking for work
The top 10 mistakes professional make when looking for work
 
Resume and job hunting secrets that might surpise you
Resume and job hunting secrets that might surpise youResume and job hunting secrets that might surpise you
Resume and job hunting secrets that might surpise you
 
Negotiation Skills: The Missing Ingredient to Career Success
Negotiation Skills: The Missing Ingredient to Career SuccessNegotiation Skills: The Missing Ingredient to Career Success
Negotiation Skills: The Missing Ingredient to Career Success
 
Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...
Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...
Let’s Work Together: How SASB Implemented DITA and Changed their Corporate Cu...
 
Helen St Denis: How to Prepare your Content for Conversion to DITA
Helen St Denis: How to Prepare your Content for Conversion to DITAHelen St Denis: How to Prepare your Content for Conversion to DITA
Helen St Denis: How to Prepare your Content for Conversion to DITA
 
Les Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEs
Les Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEsLes Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEs
Les Burnham and Patrick Baker: Collecting DITA Content Contributions from SMEs
 
Christpher Ward: What's in a Mission Statement
Christpher Ward: What's in a Mission StatementChristpher Ward: What's in a Mission Statement
Christpher Ward: What's in a Mission Statement
 
Christopher Ward and Bernard Aschwanden: Metrics That Matter
Christopher Ward and Bernard Aschwanden: Metrics That MatterChristopher Ward and Bernard Aschwanden: Metrics That Matter
Christopher Ward and Bernard Aschwanden: Metrics That Matter
 
Lorraine Aochi: Contributions to Help Content
Lorraine Aochi: Contributions to Help ContentLorraine Aochi: Contributions to Help Content
Lorraine Aochi: Contributions to Help Content
 
Rob Hanna: Leveraging Cognitive Science to Improve Topic- Based Authoring
Rob Hanna: Leveraging Cognitive Science to Improve Topic- Based AuthoringRob Hanna: Leveraging Cognitive Science to Improve Topic- Based Authoring
Rob Hanna: Leveraging Cognitive Science to Improve Topic- Based Authoring
 
The Future of Learning
The Future of Learning  The Future of Learning
The Future of Learning
 
Matt Sullivan: Bootstrapping Your Initiatives
Matt Sullivan: Bootstrapping Your InitiativesMatt Sullivan: Bootstrapping Your Initiatives
Matt Sullivan: Bootstrapping Your Initiatives
 
Steve Huffman: You Want It, Now Sell it to Management
Steve Huffman: You Want It, Now Sell it to ManagementSteve Huffman: You Want It, Now Sell it to Management
Steve Huffman: You Want It, Now Sell it to Management
 
Andrew Thomas: Frankenstein's Monster
Andrew Thomas: Frankenstein's MonsterAndrew Thomas: Frankenstein's Monster
Andrew Thomas: Frankenstein's Monster
 
Jeff Engle: Taking the Show on the Road
Jeff Engle: Taking the Show on the RoadJeff Engle: Taking the Show on the Road
Jeff Engle: Taking the Show on the Road
 
Caroline Juszczak: An Information Development Tent Revival
Caroline Juszczak: An Information Development Tent RevivalCaroline Juszczak: An Information Development Tent Revival
Caroline Juszczak: An Information Development Tent Revival
 

Recently uploaded

AI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity WebinarAI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity WebinarPrecisely
 
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...DianaGray10
 
How Accurate are Carbon Emissions Projections?
How Accurate are Carbon Emissions Projections?How Accurate are Carbon Emissions Projections?
How Accurate are Carbon Emissions Projections?IES VE
 
UiPath Community: AI for UiPath Automation Developers
UiPath Community: AI for UiPath Automation DevelopersUiPath Community: AI for UiPath Automation Developers
UiPath Community: AI for UiPath Automation DevelopersUiPathCommunity
 
VoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBXVoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBXTarek Kalaji
 
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfJamie (Taka) Wang
 
Nanopower In Semiconductor Industry.pdf
Nanopower  In Semiconductor Industry.pdfNanopower  In Semiconductor Industry.pdf
Nanopower In Semiconductor Industry.pdfPedro Manuel
 
UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7DianaGray10
 
Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Adtran
 
Cybersecurity Workshop #1.pptx
Cybersecurity Workshop #1.pptxCybersecurity Workshop #1.pptx
Cybersecurity Workshop #1.pptxGDSC PJATK
 
COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online CollaborationCOMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online Collaborationbruanjhuli
 
Empowering Africa's Next Generation: The AI Leadership Blueprint
Empowering Africa's Next Generation: The AI Leadership BlueprintEmpowering Africa's Next Generation: The AI Leadership Blueprint
Empowering Africa's Next Generation: The AI Leadership BlueprintMahmoud Rabie
 
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPAAnypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPAshyamraj55
 
ADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDE
ADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDEADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDE
ADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDELiveplex
 
Introduction to Matsuo Laboratory (ENG).pptx
Introduction to Matsuo Laboratory (ENG).pptxIntroduction to Matsuo Laboratory (ENG).pptx
Introduction to Matsuo Laboratory (ENG).pptxMatsuo Lab
 
Videogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdfVideogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdfinfogdgmi
 
UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6DianaGray10
 
Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024D Cloud Solutions
 

Recently uploaded (20)

AI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity WebinarAI You Can Trust - Ensuring Success with Data Integrity Webinar
AI You Can Trust - Ensuring Success with Data Integrity Webinar
 
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
Connector Corner: Extending LLM automation use cases with UiPath GenAI connec...
 
How Accurate are Carbon Emissions Projections?
How Accurate are Carbon Emissions Projections?How Accurate are Carbon Emissions Projections?
How Accurate are Carbon Emissions Projections?
 
UiPath Community: AI for UiPath Automation Developers
UiPath Community: AI for UiPath Automation DevelopersUiPath Community: AI for UiPath Automation Developers
UiPath Community: AI for UiPath Automation Developers
 
VoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBXVoIP Service and Marketing using Odoo and Asterisk PBX
VoIP Service and Marketing using Odoo and Asterisk PBX
 
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
activity_diagram_combine_v4_20190827.pdfactivity_diagram_combine_v4_20190827.pdf
 
Nanopower In Semiconductor Industry.pdf
Nanopower  In Semiconductor Industry.pdfNanopower  In Semiconductor Industry.pdf
Nanopower In Semiconductor Industry.pdf
 
UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7UiPath Studio Web workshop series - Day 7
UiPath Studio Web workshop series - Day 7
 
Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™Meet the new FSP 3000 M-Flex800™
Meet the new FSP 3000 M-Flex800™
 
Cybersecurity Workshop #1.pptx
Cybersecurity Workshop #1.pptxCybersecurity Workshop #1.pptx
Cybersecurity Workshop #1.pptx
 
201610817 - edge part1
201610817 - edge part1201610817 - edge part1
201610817 - edge part1
 
COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online CollaborationCOMPUTER 10: Lesson 7 - File Storage and Online Collaboration
COMPUTER 10: Lesson 7 - File Storage and Online Collaboration
 
Empowering Africa's Next Generation: The AI Leadership Blueprint
Empowering Africa's Next Generation: The AI Leadership BlueprintEmpowering Africa's Next Generation: The AI Leadership Blueprint
Empowering Africa's Next Generation: The AI Leadership Blueprint
 
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPAAnypoint Code Builder , Google Pub sub connector and MuleSoft RPA
Anypoint Code Builder , Google Pub sub connector and MuleSoft RPA
 
ADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDE
ADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDEADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDE
ADOPTING WEB 3 FOR YOUR BUSINESS: A STEP-BY-STEP GUIDE
 
20150722 - AGV
20150722 - AGV20150722 - AGV
20150722 - AGV
 
Introduction to Matsuo Laboratory (ENG).pptx
Introduction to Matsuo Laboratory (ENG).pptxIntroduction to Matsuo Laboratory (ENG).pptx
Introduction to Matsuo Laboratory (ENG).pptx
 
Videogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdfVideogame localization & technology_ how to enhance the power of translation.pdf
Videogame localization & technology_ how to enhance the power of translation.pdf
 
UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6UiPath Studio Web workshop series - Day 6
UiPath Studio Web workshop series - Day 6
 
Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024Artificial Intelligence & SEO Trends for 2024
Artificial Intelligence & SEO Trends for 2024
 

Making The Mental Shift to Topic-Based Authoring

  • 1. Making the Mental Shift to Topic-based Authoring and Content Management Leigh White DITA Specialist Lavacon October 2013
  • 2. This is really a presentation about 2
  • 4. If you don’t manage change… It will manage you 4
  • 5. Who are you? • The person responsible for planning and carrying out a TBSA* implementation     Manager Team lead Information architect ? *Topic-based, structured authoring. I will probably slip and say “DITA” but that’s not the only TBSA framework. 5
  • 6. What have you already done? • Exhaustively researched TBSA • Developed a solid business case • Sold it to the higher-ups • Gotten buy-in at all levels above you 6
  • 7. And now, the rollout… The rollout sets the tone for the whole project 7
  • 8. Have a plan • Before you present TBSA to the team, cover all your bases  Anticipate every question and opposition  Be able to communicate exactly what will happen, when, and who will be responsible: • Training • Tool selection (XML editor, CMS, etc.)* • Information architecture • Output styling****** • Legacy content conversion • Collaboration among authors* • Governance*** * These will be HUGE areas of discussion! 8
  • 9. Be honest • The learning curve will be steep • There will be extra work in the short term  Learning principles of TBSA  Learning tools  Content conversion PLUS  Ongoing work  Maybe duplicate content maintenance for a while • Be honest about what will change  Not just a move from one tool to another • Completely different approach to writing  No control over formatting and outputs  No more Lone Rangers…writers must collaborate and follow same styles and guidelines 9
  • 10. Be honest (2) • Be very specific about the rewards  Articulate the team’s pain points & note the solution • Errors & inconsistencies in documentation • Frantic scrambling near deadlines • Duplicate content in different formats • Inconsistent toolsets and processes  Articulate the company’s pain points • Customer complaints • Rising support costs • Ability to deliver innovative solutions limited by ability to provider user assistance  Base rewards discussion on the research you did to justify the move to TBSA in the first place.  If you can’t be specific about the rewards, you’re not ready to implement TBSA. 10
  • 11. Don’t get sidetracked by naysayers • Address their general concerns • But don’t get led down the garden path  “So we can’t have tables with the 3rd column of every 5th row shaded and a dotted line after rows that start with the letter G? Our clients really expect that. They’ll complain if we can’t do it.” • Stress that all conventions, especially styling conventions, are up for reevaluation  Everything is on the table.  They must be prepared to offer solid justification for their wants.  “We’ve always done it that way” is not solid justification. 11
  • 12. Enthusiasm is not necessarily contagious • Even though you explain the problems and how TBSA will solve those problems, many people will still be unconvinced  Don’t let the resistance take you by surprise • Is this the best solution? • What other solutions can we look at?  Don’t get exasperated • Lots of uncertainty and doubt associated with change • Can I learn to do this? • Increased efficiency = staff reduction? 12
  • 13. Talk to individuals • Completely open discussion • Get to the root of resistance  It might not be about the current situation at all • Previous negative experience • Ongoing life events • Set individual expectations and measurements     How will their work and responsibilities change? What is expected of them during and after the change? How they will be measured? What will success or failure mean for them and the team? 13
  • 14. Talk to individuals (2) • Everybody comes at change from a different viewpoint:  Dejuan is a writer who works on a very small, simple product with only two releases a year and only one type of documentation.  Sally is a writer who works on a very large, complex product with 3 other writers. There are 4 major releases, and dozens of patches/hotfixes a year. There are online help, user guides, and quick reference guides, each with several variations, that have to be produced for each release.  Manish is an editor who reviews the documentation, usually in PDF format, for typographical accuracy and adherence to style standards.  Nadia is an SME who contributes content, usually in Word. • Frame discussions in each person’s individual context  No one-size-fits-all approach 14
  • 15. Create ownership • Identify key people and let them help you  Every team has natural leaders outside management … people other writers naturally look up to. Involve them at the earliest practical stage and get them to help you plan.  Have them lead teams as mentors or representatives so that decisions (where practical) are made collaboratively from within the ranks instead of coming down from “on high.” 15
  • 16. Keep an open mind and stay flexible • Expect the unexpected  Things will come up that you didn’t and couldn’t have anticipated. • Personnel changes • Company reorgs/change of focus • Resistance in unexpected areas • Unexpected technical challenges • If the plan needs to change, change it  Be clear with the team about why.  If it was something you overlooked, don’t try to fake people out – (that honesty thing again). 16
  • 17. To sum up • Make sure your implementation plan is complete  Not necessarily every detail but sufficient to reassure the team that the pieces are in place and all important issues have been considered and accounted for • Be honest with the team  State the challenges up front. Don't whitewash. Be clear about the extent of the effort and its effects on everyone. Be honest about the effects on day-to-day work both in the short and long term. • Don’t get sidetracked  Resist the urge to reassure writers on every minute detail. This can turn into a sparring contest. • Don't be surprised by resistance  Just explaining the problem and showing the solution is not enough to sell the plan. 17
  • 18. To sum up (2) • Have individual discussions  Frame the change in the context of each writer's responsibilities, experience level, concerns, questions. • Create ownership  Spread responsibility for certain decisions and processes among key players on the team, not just management. • Keep an open mind and stay flexible  Be prepared to change the plan to fit changing circumstances. 18
  • 20. Available in the Lavacon bookstore and from Amazon leigh.white@ixiasoft.com CONTACT ME 20