DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA
- ISBN-10
- 0132374323
- ISBN-13
- 9780132374323
- Category
- Computers
- Pages
- 266
- Language
- English
- Published
- 2011-08-01
- Publisher
- Pearson Education
- Authors
- Laura Bellamy, Michelle Carey, Jenifer Schlotfeldt
Description
The Start-to-Finish, Best-Practice Guide to Implementing and Using DITA Darwin Information Typing Architecture (DITA) is today’s most powerful toolbox for constructing information. By implementing DITA, organizations can gain more value from their technical documentation than ever before. Now, three DITA pioneers offer the first complete roadmap for successful DITA adoption, implementation, and usage. Drawing on years of experience helping large organizations adopt DITA, the authors answer crucial questions the “official” DITA documents ignore, including: Where do you start? What should you know up front? What are the pitfalls in implementing DITA? How can you avoid those pitfalls? The authors begin with topic-based writing, presenting proven best practices for developing effective topics and short descriptions. Next, they address content architecture, including how best to set up and implement DITA maps, linking strategies, metadata, conditional processing, and content reuse. Finally, they offer “in the trenches” solutions for ensuring quality implementations, including guidance on content conversion. Coverage includes: Knowing how and when to use each DITA element–and when not to Writing “minimalist,” task-oriented information that quickly meets users’ needs Creating effective task, concept, and reference topics for any product, technology, or service Writing effective short descriptions that work well in all contexts Structuring DITA maps to bind topics together and provide superior navigation Using links to create information webs that improve retrievability and navigation Gaining benefits from metadata without getting lost in complexity Using conditional processing to eliminate redundancy and rework Systematically promoting reuse to improve quality and reduce costs Planning, resourcing, and executing effective content conversion Improving quality by editing DITA content and XML markup¿ If you’re a writer, editor, information architect, manager, or consultant who evaluates, deploys, or uses DITA, this book will guide you all the way to success. Also see the other books in this IBM Press series: Developing Quality Technical Information: A Handbook for Writers and Editors The IBM Style Guide: Conventions for Writers and Editors
Get the book
Other editions
-
- 2011-09-01
- 281 pages
- Paperback
- IBM Press
Similar books
-
The DITA Style Guide: Best Practices for Authors
By Tony SelfThe DITA Style Guide: Best Practices for Authors provides comprehensive, practical explanations of DITA elements and attributes.
-
DITA Best Practices, Video Enhanced Edition: A Roadmap for Writing, Editing, and Architecting in DITA
By Laura Bellamy, Michelle Carey, Jenifer SchlotfeldtThis is the video enhanced eBook version of the print title. Watch video demonstrations to see how to implement some of the advanced features of DITA discussed in this book.
-
Developing Quality Technical Information: A Handbook for Writers and Editors
By Eric Radzinski, Michelle Carey, Deirdre LongoPacked with guidelines, checklists, and before-and-after examples, Developing Quality Technical Information, Third Edition is an indispensable resource for the future of technical communication.
-
DITA 101: Fundamentals of DITA for Authors and Managers
By Ann Rockley, Steve Manning, Charles CooperPlease Note that DITA 101 has been replaced by DITA 101 - Second Edition.For up-to-date information, please purchase the Second Edition.
-
DocBook: The Definitive Guide
By Norman Walsh, Leonard MuellnerIn this book, you'll find : A brief introduction to SGML and XML ; a guide to creating documents with the DocBook DTD and associated stylesheets.
-
Your Beauty Mark: The Ultimate Guide to Eccentric Glamour
By Dita Von TeeseIn Your Beauty Mark: The Ultimate Guide to Eccentric Glamour, Dita and co-writer Rose Apodaca take you through every step of Dita’s glamour arsenal, and includes friends—masters in makeup, hair, medicine, and exercise as well as some of ...
-
Multilingual Natural Language Processing Applications: From Theory to Practice
By Imed Zitouni, Daniel BikelThis book contains important new contributions from leading researchers at IBM, Google, Microsoft, Thomson Reuters, BBN, CMU, University of Edinburgh, University of Washington, University of North Texas, and others.
-
In Intimate Detail: How to Choose, Wear, and Love Lingerie
By Cora HarringtonCovering everything from basic bras and panties to special occasion wear, shapewear, hosiery, corsets, and more, this no-nonsense handbook empowers you to confidently buy, wear, and care for the underpinnings of your dreams.
-
The IBM Style Guide: Conventions for Writers and Editors
By Francis DeRespinisStraight from IBM: complete, proven guidelines for writing consistent, clear, concise, consumable, reusable, and easy to- translate content Brings together everything IBM has learned about writing outstanding technical and business content.
-
Creating Intelligent Content with Lightweight DITA
By Carlos EviaRhetorical work in the age of content management: Implications for the field of technical communication. Journal of Business and Technical Communication, ... Content strategy: Connecting the dots between business, brand, and benefits.