The Agony of Alice

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

How can someone be in love with two people at the same time? It doesn't make sense to Alice—until Sam, her friend from Camera Club, starts to pay attention to her. Sam is quiet, gentle, and a terrific dancer, and Alice likes being with him. But Alice has been Patrick’s girlfriend for almost two years—so why is she interested in another guy?

But, she reasons, if you don't have a mother, maybe a sister would help. Maybe lots of sisters. A worldwide sisterhood! Sisterhood means more sympathy and less likely odds that the next horrible thing will strike when Alice is by herself. But, Sisterhood also comes with a whole new set of problems for Alice. Can she be Sisters with all three girls who want to be her brother Lester's girlfriend? In fact, how do boys fit into Universal Sisterhood at all? And how far should she you go when being part of the crowd means doing something you don't want to do?

Alice McKinley likes her life, but she senses things are changing. She gets a little bored by her best friends Elizabeth’s and Pamela’s obsession with clothes and makeup. She’s just not that interested. And though she is very interested in her boyfriend, Patrick, she’s not entirely sure how to keep their relationship going. Alice is struggling to figure out how she feels about things—and then how her feelings fits into what other people think she should be feeling.