1
DON’T LOSE IT, REUSE ITWORKING WITH LEGACY CONTENT
© Adam Sanyo, 2016 UA Europe Budapest, 2016
© Adam Sanyo, 2016 UA Europe Budapest, 2016 2
Agenda1. Strategic decisions
2. Tactical decisions
3. Resourcing decisions
© Adam Sanyo, 2016 UA Europe Budapest, 2016 3
My background
Celebrating 6 years today• Six years of experience in technical writing.
• Worked on two different migration projects.
• Degree in English and Linguistics.
• Currently working for ARM as an information developer.
• “Love at first sight” when encountering DITA in 2010.
4
1. Strategic decisions
• Conversion process
• Costs
• Main resources
• Success criteria
© Adam Sanyo, 2016 UA Europe Budapest, 2016
© Adam Sanyo, 2016 UA Europe Budapest, 2016 5
How do you start off a legacy conversion project?Note: It is assumed that you already use a structured authoring model and tool (such as MadCap Flare, oXygen, etc.) and you have a content creation workflow in place.
Things you need at the start:
• CCMS
• People with structured authoring experience
• Money to invest
• A prototype project
• A conversion process
© Adam Sanyo, 2016 UA Europe Budapest, 2016 6
High-level strategy for legacy content migration
• Run a prototype project
• Create reuse processes and guidelines
• Write a conversion script
• Visualize your end product
© Adam Sanyo, 2016 UA Europe Budapest, 2016 7
Is it expensive to migrate content?
Yes, but it can pay off if:
• You reuse the content you convert
• You create a scalable solution
• You know what you are doing
Standard costs:
• Software (authoring tool)
• CCMS
• Specialist cost
• Lost time
© Adam Sanyo, 2016 UA Europe Budapest, 2016 8
What are the measurable cost savings?Conversion process success criteria
• Reduced translation cost
• Reduced authoring time
• Documentation is used more extensively
CostTime
Productivity
© Adam Sanyo, 2016 UA Europe Budapest, 2016 9
How does the legacy content gets reused?
• Have a standard workflow first integrate legacy conversion into it
• Analyze existing content
• Do a content audit if needed
© Adam Sanyo, 2016 UA Europe Budapest, 2016 10
2. Tactical decisions
• Effective writing and minimalism
• Metadata
• Separating topic types
© Adam Sanyo, 2016 UA Europe Budapest, 2016 11
Is structured writing a good thing?YES, because of:
• Scalability
• Minimalism
BUT:
• Not suitable for every product
• Authors may find it hard
12
What is the key to quality structured content?Metadata
Transparency
Reusability
• Every small piece of content must be searchable.
• It is the essential that writers know the extent of the existing content.
• In a structured model, you can reuse content across different publications and inside your products as well.
© Adam Sanyo, 2016 UA Europe Budapest, 2016
13
Authoring decisionsLet us assume that you are using the standard DITA framework (task-concept reference topics) and one or two extra topic types on top of that.
• Chunk your content into topics
• Start with task topics
• Create a reuse strategy
• Decide the level of deviation from the original content
© Adam Sanyo, 2016 UA Europe Budapest, 2016
© Adam Sanyo, 2016 UA Europe Budapest, 2016 14
General reuse rules• Gain flexibility by using keys• Reuse block elements • Rewrite two or more similar topics
if they become reusable after that
• Always consider conditional processing
© Adam Sanyo, 2016 UA Europe Budapest, 2016 15
3. Resource decisions and problem solving
• Saving costs and distributing tasks
• Solving resource problems
• Motivation of different parties in the conversion process
© Adam Sanyo, 2016 UA Europe Budapest, 2016 16
Cost and resource saving tips
• Outsource some of the easy but manual tasks.
• Distribute tasks among team members based on their strengths.
• Make sure that everyone knows how the converted documents will be reused.
• Spend more time and effort in the planning stage.
17
Usual problems and solutionsProblems
1. The team is reluctant to move into DITA.2. There are resource constraints.3. The business case is not strong enough.4. Knowledge sharing is not strong between
teams (there is a risk of “reinventing the wheel” cases).
Solutions
1. Provide training and nominate DITA champions who can push the team forward.
2. Create a small but scalable prototype project first as a test.
3. You may need to reconsider the scope of your legacy conversion.
4. Pull in members from different teams to improve knowledge sharing.
© Adam Sanyo, 2016 UA Europe Budapest, 2016
Who benefits from a migration project (and how?)
Management
• Lot of data is available to plan structured writing projects
• Can boost confidence in your team after the project
• Helps to remove silos
Writers
• It is good to have DITA experience in your CV
• The writing role can be expanded
• Better integration with other teams
Suppliers / 3rd party
• Easier to calculate revenue for translation requests
• Potential business opportunity for consultants
• Recurring work for XSLT experts
© Adam Sanyo, 2016 UA Europe Budapest, 2016
18
© Adam Sanyo, 2016 UA Europe Budapest, 2016 19
We have about 8 minutes left…
Q&A
© Adam Sanyo, 2016 UA Europe Budapest, 2016 21
Image references
• Creative Commons license for images from Wikipedia
• Writing flowchart: own work
• Building blocks: www.softwareag.com
• Technical writing chart: www.idratherbewriting.com