SlideShare a Scribd company logo
Keeping the Content Train on the Tracks
(and on Topic)
Robert D Anderson and Kristen James Eberlein
Lavacon 2015
How can critical content evolve
when it also cannot change?
• When customers rely on your content, your
content might become mired in the past.
• In many cases, new or revised content must
remain compatible with prior versions.
• How can problematic content be updated,
while simultaneously moving to the future?
DITA 1.3: A case study
• DITA 1.3 is the latest version of the DITA standard
• Creating DITA 1.3 came with…
– Editorial restrictions: Strict guarantee of backwards
compatibility (old rules cannot change)
– Cost issues: No tool budget, mostly volunteer resources
– Historical issues: Problematic content from old versions
– Customer issues: One specification, many audiences
– People issues: When a document is (generally) produced
by consensus, how should we handle disagreements?
– Perception issues: 1000+ pages? Really?
In this session, you will learn
• How the editors of DITA 1.3 handled those issues and
more – usually, with success:
– What process changes allowed us to add new content
instantly (versus 2+ years with DITA 1.2)?
– How did we add new content while simultaneously
reducing page count?
– Dealing with the audience tug-of-war: Does improved
readability necessarily equal less precision?
– Entire businesses depend on this document. How do we
make sure they have a voice?
– Producing this document is, and must be, a team effort.
With no real stick, how did we find the right carrots to
improve participation?
About the speakers
• Robert D Anderson
Robert has spent over 15 years working
on SGML/XML publishing tools at
IBM; 13 of those years have been
spent primarily with DITA or the DITA
Open Toolkit. Robert is co-editor of
the DITA 1.1, 1.2, and 1.3
specifications, making him one of
those rare developers who has to use
the tools that he supports. If you're
not careful, he will tell you (and show
you!) how he uses DITA to publish his
music collection and book library.
• Kristen James Eberlein
Kris is Chair of the OASIS DITA Technical
Committee and owner of Eberlein
Consulting LLC, a company that helps
people develop or refine their DITA
implementations. She also is co-editor of
the DITA 1.2 and 1.3 specifications.
Trained as a historian, she’s worn almost
all the content worker hats you can
imagine: Information developer, team
lead, information architect, tool smith …
When not herding cats, she drives a Mini
Cooper S and takes trains whenever
possible.
About the speakers
• Robert D Anderson
Robert has spent over 15 years working
on SGML/XML publishing tools at
IBM; 13 of those years have been
spent primarily with DITA or the DITA
Open Toolkit. Robert is co-editor of
the DITA 1.1, 1.2, and 1.3
specifications, making him one of
those rare developers who has to use
the tools that he supports. If you're
not careful, he will tell you (and show
you!) how he uses DITA to publish his
music collection and book library.
• Kristen James Eberlein
Kris is Chair of the OASIS DITA Technical
Committee and owner of Eberlein
Consulting LLC, a company that helps
people develop or refine their DITA
implementations. She also is co-editor of
the DITA 1.2 and 1.3 specifications.
Trained as a historian, she’s worn almost
all the content worker hats you can
imagine: Information developer, team
lead, information architect, tool smith …
When not herding cats, she drives a Mini
Cooper S and takes trains whenever
possible.

More Related Content

Similar to Keeping the Content Train on the Tracks (and on Topic)

Painless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XMLPainless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XML
Scott Abel
 
Creation of a Digital Library
Creation of a Digital LibraryCreation of a Digital Library
Creation of a Digital Library
Aileen Marshall
 
Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...
Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...
Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...
BookNet Canada
 

Similar to Keeping the Content Train on the Tracks (and on Topic) (20)

Painless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XMLPainless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XML
 
Creation of a Digital Library
Creation of a Digital LibraryCreation of a Digital Library
Creation of a Digital Library
 
Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...
Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...
Who Does What to Make Great EPUB? How to Build an Airplane in Mid-Air - Sabin...
 
Data Mining & Engineering
Data Mining & EngineeringData Mining & Engineering
Data Mining & Engineering
 
Back to Basics: Getting the Content Essentials Right
Back to Basics: Getting the Content Essentials RightBack to Basics: Getting the Content Essentials Right
Back to Basics: Getting the Content Essentials Right
 
Standards Through Interoperability? Really?
Standards Through Interoperability? Really?Standards Through Interoperability? Really?
Standards Through Interoperability? Really?
 
Opening up Open Source
Opening up Open SourceOpening up Open Source
Opening up Open Source
 
Planning and Managing Digital Library & Archive Projects
Planning and Managing Digital Library & Archive ProjectsPlanning and Managing Digital Library & Archive Projects
Planning and Managing Digital Library & Archive Projects
 
One Tool to Help Them All - Leigh White
One Tool to Help Them All -  Leigh WhiteOne Tool to Help Them All -  Leigh White
One Tool to Help Them All - Leigh White
 
How To Write A Conclusion To A Research Paper
How To Write A Conclusion To A Research PaperHow To Write A Conclusion To A Research Paper
How To Write A Conclusion To A Research Paper
 
Information Architecture Explained
Information Architecture ExplainedInformation Architecture Explained
Information Architecture Explained
 
DITA Collaboration for Content
DITA Collaboration for ContentDITA Collaboration for Content
DITA Collaboration for Content
 
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
 
Zach Larson - Sidereel - write on-the_walls_20110511
Zach Larson - Sidereel - write on-the_walls_20110511Zach Larson - Sidereel - write on-the_walls_20110511
Zach Larson - Sidereel - write on-the_walls_20110511
 
What is DITA? And Is It Right for Your Team or Project?
What is DITA? And Is It Right for Your Team or Project?What is DITA? And Is It Right for Your Team or Project?
What is DITA? And Is It Right for Your Team or Project?
 
3.15.17 DSpace: How to Contribute Webinar Slides
3.15.17 DSpace: How to Contribute Webinar Slides3.15.17 DSpace: How to Contribute Webinar Slides
3.15.17 DSpace: How to Contribute Webinar Slides
 
Lies, damned lies and statistics
Lies, damned lies and statistics Lies, damned lies and statistics
Lies, damned lies and statistics
 
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
 
Presentation Email Expiration Date Initiative
Presentation Email Expiration Date InitiativePresentation Email Expiration Date Initiative
Presentation Email Expiration Date Initiative
 
How to make a better world
How to make a better worldHow to make a better world
How to make a better world
 

Recently uploaded

527598851-ppc-due-to-various-govt-policies.pdf
527598851-ppc-due-to-various-govt-policies.pdf527598851-ppc-due-to-various-govt-policies.pdf
527598851-ppc-due-to-various-govt-policies.pdf
rajpreetkaur75080
 

Recently uploaded (15)

05232024 Joint Meeting - Community Networking
05232024 Joint Meeting - Community Networking05232024 Joint Meeting - Community Networking
05232024 Joint Meeting - Community Networking
 
Bitcoin Lightning wallet and tic-tac-toe game XOXO
Bitcoin Lightning wallet and tic-tac-toe game XOXOBitcoin Lightning wallet and tic-tac-toe game XOXO
Bitcoin Lightning wallet and tic-tac-toe game XOXO
 
Hi-Tech Industry 2024-25 Prospective.pptx
Hi-Tech Industry 2024-25 Prospective.pptxHi-Tech Industry 2024-25 Prospective.pptx
Hi-Tech Industry 2024-25 Prospective.pptx
 
Sharpen existing tools or get a new toolbox? Contemporary cluster initiatives...
Sharpen existing tools or get a new toolbox? Contemporary cluster initiatives...Sharpen existing tools or get a new toolbox? Contemporary cluster initiatives...
Sharpen existing tools or get a new toolbox? Contemporary cluster initiatives...
 
Competition and Regulation in Professional Services – KLEINER – June 2024 OEC...
Competition and Regulation in Professional Services – KLEINER – June 2024 OEC...Competition and Regulation in Professional Services – KLEINER – June 2024 OEC...
Competition and Regulation in Professional Services – KLEINER – June 2024 OEC...
 
Pollinator Ambassador Earth Steward Day Presentation 2024-05-22
Pollinator Ambassador Earth Steward Day Presentation 2024-05-22Pollinator Ambassador Earth Steward Day Presentation 2024-05-22
Pollinator Ambassador Earth Steward Day Presentation 2024-05-22
 
123445566544333222333444dxcvbcvcvharsh.pptx
123445566544333222333444dxcvbcvcvharsh.pptx123445566544333222333444dxcvbcvcvharsh.pptx
123445566544333222333444dxcvbcvcvharsh.pptx
 
Eureka, I found it! - Special Libraries Association 2021 Presentation
Eureka, I found it! - Special Libraries Association 2021 PresentationEureka, I found it! - Special Libraries Association 2021 Presentation
Eureka, I found it! - Special Libraries Association 2021 Presentation
 
Oracle Database Administration I (1Z0-082) Exam Dumps 2024.pdf
Oracle Database Administration I (1Z0-082) Exam Dumps 2024.pdfOracle Database Administration I (1Z0-082) Exam Dumps 2024.pdf
Oracle Database Administration I (1Z0-082) Exam Dumps 2024.pdf
 
The Canoga Gardens Development Project. PDF
The Canoga Gardens Development Project. PDFThe Canoga Gardens Development Project. PDF
The Canoga Gardens Development Project. PDF
 
Acorn Recovery: Restore IT infra within minutes
Acorn Recovery: Restore IT infra within minutesAcorn Recovery: Restore IT infra within minutes
Acorn Recovery: Restore IT infra within minutes
 
Getting started with Amazon Bedrock Studio and Control Tower
Getting started with Amazon Bedrock Studio and Control TowerGetting started with Amazon Bedrock Studio and Control Tower
Getting started with Amazon Bedrock Studio and Control Tower
 
Writing Sample 2 -Bridging the Divide: Enhancing Public Engagement in Urban D...
Writing Sample 2 -Bridging the Divide: Enhancing Public Engagement in Urban D...Writing Sample 2 -Bridging the Divide: Enhancing Public Engagement in Urban D...
Writing Sample 2 -Bridging the Divide: Enhancing Public Engagement in Urban D...
 
0x01 - Newton's Third Law: Static vs. Dynamic Abusers
0x01 - Newton's Third Law:  Static vs. Dynamic Abusers0x01 - Newton's Third Law:  Static vs. Dynamic Abusers
0x01 - Newton's Third Law: Static vs. Dynamic Abusers
 
527598851-ppc-due-to-various-govt-policies.pdf
527598851-ppc-due-to-various-govt-policies.pdf527598851-ppc-due-to-various-govt-policies.pdf
527598851-ppc-due-to-various-govt-policies.pdf
 

Keeping the Content Train on the Tracks (and on Topic)

  • 1. Keeping the Content Train on the Tracks (and on Topic) Robert D Anderson and Kristen James Eberlein Lavacon 2015
  • 2. How can critical content evolve when it also cannot change? • When customers rely on your content, your content might become mired in the past. • In many cases, new or revised content must remain compatible with prior versions. • How can problematic content be updated, while simultaneously moving to the future?
  • 3. DITA 1.3: A case study • DITA 1.3 is the latest version of the DITA standard • Creating DITA 1.3 came with… – Editorial restrictions: Strict guarantee of backwards compatibility (old rules cannot change) – Cost issues: No tool budget, mostly volunteer resources – Historical issues: Problematic content from old versions – Customer issues: One specification, many audiences – People issues: When a document is (generally) produced by consensus, how should we handle disagreements? – Perception issues: 1000+ pages? Really?
  • 4. In this session, you will learn • How the editors of DITA 1.3 handled those issues and more – usually, with success: – What process changes allowed us to add new content instantly (versus 2+ years with DITA 1.2)? – How did we add new content while simultaneously reducing page count? – Dealing with the audience tug-of-war: Does improved readability necessarily equal less precision? – Entire businesses depend on this document. How do we make sure they have a voice? – Producing this document is, and must be, a team effort. With no real stick, how did we find the right carrots to improve participation?
  • 5. About the speakers • Robert D Anderson Robert has spent over 15 years working on SGML/XML publishing tools at IBM; 13 of those years have been spent primarily with DITA or the DITA Open Toolkit. Robert is co-editor of the DITA 1.1, 1.2, and 1.3 specifications, making him one of those rare developers who has to use the tools that he supports. If you're not careful, he will tell you (and show you!) how he uses DITA to publish his music collection and book library. • Kristen James Eberlein Kris is Chair of the OASIS DITA Technical Committee and owner of Eberlein Consulting LLC, a company that helps people develop or refine their DITA implementations. She also is co-editor of the DITA 1.2 and 1.3 specifications. Trained as a historian, she’s worn almost all the content worker hats you can imagine: Information developer, team lead, information architect, tool smith … When not herding cats, she drives a Mini Cooper S and takes trains whenever possible.
  • 6. About the speakers • Robert D Anderson Robert has spent over 15 years working on SGML/XML publishing tools at IBM; 13 of those years have been spent primarily with DITA or the DITA Open Toolkit. Robert is co-editor of the DITA 1.1, 1.2, and 1.3 specifications, making him one of those rare developers who has to use the tools that he supports. If you're not careful, he will tell you (and show you!) how he uses DITA to publish his music collection and book library. • Kristen James Eberlein Kris is Chair of the OASIS DITA Technical Committee and owner of Eberlein Consulting LLC, a company that helps people develop or refine their DITA implementations. She also is co-editor of the DITA 1.2 and 1.3 specifications. Trained as a historian, she’s worn almost all the content worker hats you can imagine: Information developer, team lead, information architect, tool smith … When not herding cats, she drives a Mini Cooper S and takes trains whenever possible.