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”
We all know (thanks, if nothing else, to the NSA), that metadata is all around us, hard at work behind the scenes making data and content more valuable, accessible, useful. In fact, the term has made it so far into the popular lexicon and consciousness that it is now used in news stories unaccompanied by a definition. And it’s proliferation has been accompanied by a sense of urgency. Folks keep talking about metadata’s tremendous importance: It’s “the new black,” even “the new data”!
In this Dojo session, we’ll establish a shared definition and understanding of what metadata is and then consider specifically what’s in it for “us.” How is metadata being used in the technical content arena, and how is this impacting our career paths and opportunities? What do we need to know? Continue reading “Metadata: Queen to King Content?”
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