DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA

DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA
ISBN-10
0132480522
ISBN-13
9780132480529
Category
Computers
Pages
281
Language
English
Published
2011-09-01
Publisher
IBM Press
Authors
Laura Bellamy, Michelle Carey, Jenifer Schlotfeldt

Description

The complete, best-practice guide to implementing and using DITA: expert, 'in the trenches' advice you can't find anywhere else! • •Answers the crucial questions the 'official' DITA documentation doesn't cover, from 'Where do you start?' to 'How do you avoid the pitfalls?' •Reflects the authors' unsurpassed experience in all facets of enterprise-scale DITA planning, deployment, and day-to-day usage. •Offers practical guidance on topic-based writing, content architecture, and ensuring a quality implementation. Darwin Information Typing Architecture (DITA) is today's most powerful toolbox for constructing information. Implementing DITA can help organizations significantly improve the value of their technical documentation. This book brings together best practices and real-world guidance for success with DITA deployment and usage. Drawing on years of experience helping organizations implement DITA, the authors answer the crucial questions the 'official' DITA documents ignore: • •Where do you start in implementing DITA? •What should you know before you start writing? •What are DITA's gotchas and pitfalls? •Which DITA elements, attributes, and features should you know upfront, and which can wait? Technical writers and their managers can use this book as a complete roadmap for DITA adoption and implementation. Part 1 walks through the basics of topic-based writing, especially the importance of writing accurate, usable short descriptions. Part 2 covers more advanced topics related to content architecture, including DITA maps, linking strategies, metadata, conditional processing, and content reuse. Part 3 covers quality DITA implementations, offering crucial guidance for converting content to DITA, whether you do it in-house or utilize a third-party vendor.

Other editions

Similar books

  • Family History Digital Libraries
    By William Sims Bainbridge

    One named Sara and Timberlake had 11 male workers, 1 female worker, and 4 children workers, so it might have employed the Minor family.

  • Foundation Dreamweaver MX
    By Craig Grannell, Jerome Turner, Matt Stephens

    So here's what we need to do to arrive at our layout: s Create the main table to hold all the page elements. s Deal with the navigation area which is ...

  • Cisco CCNA Certification, 2 Volume Set: Exam 200-301
    By Todd Lammle

    This inclusive, two-book set provides what you need to know to succeed on the new CCNA exam. The set includes Understanding Cisco Networking Technologies: Volume 1 and the CCNA Certification Study Guide: Volume 2.

  • CompTIA Network+ Study Guide: Exam N10-006
    By Todd Lammle

    ... you can use: –a –A –c –n –r –R –S –s All nbtstat switches are case sensitive. Generally speaking, lowercase switches deal with NetBIOS names of hosts, ...

  • CompTIA Network+ Study Guide with Online Labs: N10-007 Exam
    By Todd Lammle, Jon Buhagiar

    ... you can use: –a –A –c –n –r –R –S –s All nbtstat switches are case sensitive. Generally speaking, lowercase switches deal with NetBIOS names of hosts, ...

  • CCNA: Cisco Certified Network Associate FastPass
    By Todd Lammle

    S The S reference point defines the point between the customer router and an ... with the letter E deal with using ISDN on the existing telephone network.

  • Stranger in the Chat Room
    By Todd Hafer, Jedd Hafer

    A sequel to In the Chat Room With God finds a group of teens contacted by a mysterious and increasingly malevolent character who claims to know about their encounters with the Almighty and challenges their beliefs. Original.

  • Error Correction Coding: Mathematical Methods and Algorithms
    By Todd K. Moon

    M M−1∑ k=0 −∞ ∞ k=0 The average energy per signal E s ∫ can be related to the ... we will deal primarily with additive white Gaussian noise (AWGN), ...

  • Security+ Training Guide
    By Todd King

    ... to deal with most , but unfortunately not all , of these potential threats . ... The S / MIME standard implements encryption for message content using ...

  • CCDA: Cisco Certified Design Associate Study Guide: Exam 640-861
    By Todd Lammle, Andy Barkl

    S reference point The S reference point defines the reference point between ... with the letter E deal with using ISDN on the existing telephone network.