Having problems with inconsistently written documentation? Do your user manuals need some help themselves? If so, then you need a style guide for your technical writing team. We’re not talking about what they should wear, but how they should write.
Content couturier Keith Schengili-Roberts (IXIASOFT) talks about what they are, why you need them and how to use them effectively. While not exclusively focusing on DITA, Keith will also talk about why a style guide is a necessity for any team working with DITA.
Continue reading “Style Guides: Fashionable But Also Practical”
Mindful and enlightened TCs working in a CMS environment maximize re-use and create global-ready content that meets their audiences’ needs while reducing costs and improving efficiency. Controlled Language, implemented correctly, can help you achieve these goals. However, many companies implement Simplified Technical English or other controlled language initiatives, but struggle to maximize the benefits, or discover issues with the human side of change management. In this presentation, we will discuss best practices for implementing controlled language, identify some potential challenges, provide recommendations for working around them.
After the presentation, participants will have a better understanding of these concepts:
- Best practices for implementing controlled language
- Risk mitigation and the importance of pilot projects
- Effect of implementing controlled language on your TMs
- Benefits and ROI of controlled language
TC Dojo Master
Kit Brown-Hoekstra, Comgenesis, is an STC Fellow and STC Society Immediate Past President. She’s an experienced consultant with over 25 years of experience in technical communication, much of it working with localization teams. As Principal of Comgenesis, Kit provides consulting and training to her clients on a variety of topics, including localization, content strategy, and content management. She speaks at conferences worldwide and publishes regularly in industry magazines. Her blog is www.pangaeapapers.com.
Watch the Video
View the Slides
DITA was built around the idea of content reuse, but many content creators are not maximizing reuse within their own documents. When DITA content is optimized for reuse, content creators can focus on writing new content, reduce localization costs, and deliver more consistent content.
In this presentation, IXIASOFT’s DITA Specialist Keith Schengili-Roberts will examine the various levels of reuse possible within DITA, including what you need to know to get the most out of topic-level reuse, phrase-level reuse, using keys effectively and more. He will also answer common questions relating to content reuse, including:
- What are the benefits of DITA-based content reuse?
- How do you measure content reuse?
- What levels of reuse are considered optimal?
- Can you go too far with content reuse?
Aimed at both new and experienced DITA users, Keith’s presentation looks not only at how to create effective content for reuse, but also why it matters.
Visiting TC Dojo Master:
Keith Schengili-Roberts is a DITA Information Architect at IXIASOFT, DITA evangelist and technical writing nerd. Keith is also an award-winning lecturer on Information Architecture at the University of Toronto’s iSchool, and Durham College. He is also an active member of the OASIS DITA Technical Committee, and can often be found presenting at conferences, working with customers, and researching how DITA is being used and sharing those results with the DITA community. Keith’s popular industry blog DITAWriter.com has become a focal point on DITA resources and best practices. Connect with Keith on Twitter @KeithIXIASOFT.
Watch the Video
About the TC Dojo
The TC Dojo is brought to you by Single-Sourcing Solutions. Sign up on our mailing list, so you get notified about upcoming sessions before they happen! http://join.tcdojo.org
You tell us what you want to learn and we find the experts. Visit our page to register and attend up coming TC Dojo sessions live. Find us on the web: http://www.tcdojo.org