DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA (IBM Press)

3.78 avg rating
( 45 ratings by Goodreads )
 
9780132480529: DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA (IBM Press)

&>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

"synopsis" may belong to another edition of this title.

About the Author:


Laura Bellamy is an Information Architect at VMware, Inc. and a technical communications instructor at University of California Santa Cruz Extension. Laura has been a long-time DITA champion, working at IBM during the adoption and proliferation of DITA. Throughout her career, she has worked on many facets of DITA implementation and now dreams in XML.


Michelle Carey is a technical editor at IBM and a technical communications instructor at University of California Santa Cruz Extension. Michelle has taught IBM teams and users’ groups about best practices for authoring in DITA, topic-based writing, writing for translation, editing user interfaces, and writing effective error messages. She is also a coauthor of the book Developing Quality Technical Information. Michelle loves to ride motorcycles and mountain bikes, herd cats, and diagram sentences.

 

Jenifer Schlotfeldt is a project leader, information developer, and technical leader at IBM and a technical communications instructor at the University of California Santa Cruz Extension. She has been authoring, testing, and teaching DITA since 2003. She has converted documentation to DITA, authored new content in DITA, contributed to new DITA specializations, and created many training materials for different facets of DITA authoring.

"About this title" may belong to another edition of this title.

Top Search Results from the AbeBooks Marketplace

1.

Michelle Carey, Jenifer Schlotfeldt, Laura Bellamy
Published by Pearson Education (US), United States (2011)
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Paperback Quantity Available: 10
Seller
The Book Depository
(London, United Kingdom)
Rating
[?]

Book Description Pearson Education (US), United States, 2011. Paperback. Book Condition: New. Language: English . Brand New Book. >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. Bookseller Inventory # AAK9780132480529

More Information About This Seller | Ask Bookseller a Question

Buy New
25.22
Convert Currency

Add to Basket

Shipping: FREE
From United Kingdom to U.S.A.
Destination, Rates & Speeds

2.

Laura Bellamy
Published by Pearson Education (2011)
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Quantity Available: > 20
Seller
Books2Anywhere
(Fairford, GLOS, United Kingdom)
Rating
[?]

Book Description Pearson Education, 2011. PAP. Book Condition: New. New Book. Shipped from UK in 4 to 14 days. Established seller since 2000. Bookseller Inventory # PB-9780132480529

More Information About This Seller | Ask Bookseller a Question

Buy New
21.22
Convert Currency

Add to Basket

Shipping: 9
From United Kingdom to U.S.A.
Destination, Rates & Speeds

3.

Michelle Carey, Jenifer Schlotfeldt, Laura Bellamy
Published by Pearson Education (US), United States (2011)
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Paperback Quantity Available: 10
Seller
The Book Depository US
(London, United Kingdom)
Rating
[?]

Book Description Pearson Education (US), United States, 2011. Paperback. Book Condition: New. Language: English . Brand New Book. >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. Bookseller Inventory # AAK9780132480529

More Information About This Seller | Ask Bookseller a Question

Buy New
31.75
Convert Currency

Add to Basket

Shipping: FREE
From United Kingdom to U.S.A.
Destination, Rates & Speeds

4.

Bellamy, LauraCarey, MichelleSchlotfeldt, Jenifer
Published by Prentice Hall
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Quantity Available: > 20
Seller
INDOO
(Avenel, NJ, U.S.A.)
Rating
[?]

Book Description Prentice Hall. Book Condition: New. Brand New. Bookseller Inventory # 0132480522

More Information About This Seller | Ask Bookseller a Question

Buy New
29.28
Convert Currency

Add to Basket

Shipping: 2.69
Within U.S.A.
Destination, Rates & Speeds

5.

Bellamy, Laura
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Quantity Available: 3
Seller
Pbshop
(Wood Dale, IL, U.S.A.)
Rating
[?]

Book Description 2011. PAP. Book Condition: New. New Book.Shipped from US within 10 to 14 business days. Established seller since 2000. Bookseller Inventory # IB-9780132480529

More Information About This Seller | Ask Bookseller a Question

Buy New
33.22
Convert Currency

Add to Basket

Shipping: 3.07
Within U.S.A.
Destination, Rates & Speeds

6.

Michelle Carey, Jenifer Schlotfeldt, Laura Bellamy
Published by Pearson Education (US), United States (2011)
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Paperback Quantity Available: 10
Seller
Book Depository hard to find
(London, United Kingdom)
Rating
[?]

Book Description Pearson Education (US), United States, 2011. Paperback. Book Condition: New. Language: English . This book usually ship within 10-15 business days and we will endeavor to dispatch orders quicker than this where possible. Brand New Book. >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. Bookseller Inventory # BZV9780132480529

More Information About This Seller | Ask Bookseller a Question

Buy New
38.63
Convert Currency

Add to Basket

Shipping: FREE
From United Kingdom to U.S.A.
Destination, Rates & Speeds

7.

Bellamy, Laura
Published by IBM Press
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Quantity Available: 1
Seller
Ohmsoft LLC
(Lake Forest, IL, U.S.A.)
Rating
[?]

Book Description IBM Press. Book Condition: Brand New. Ships from USA. FREE domestic shipping. Bookseller Inventory # 0132480522

More Information About This Seller | Ask Bookseller a Question

Buy New
40.55
Convert Currency

Add to Basket

Shipping: FREE
Within U.S.A.
Destination, Rates & Speeds

8.

Laura Bellamy, Michelle Carey, Jenifer Schlotfeldt
Published by Pearson Education 2011-09-30, Upper Saddle River, N.J. |London (2011)
ISBN 10: 0132480522 ISBN 13: 9780132480529
New paperback Quantity Available: 1
Seller
Blackwell's
(Oxford, OX, United Kingdom)
Rating
[?]

Book Description Pearson Education 2011-09-30, Upper Saddle River, N.J. |London, 2011. paperback. Book Condition: New. Bookseller Inventory # 9780132480529

More Information About This Seller | Ask Bookseller a Question

Buy New
38.72
Convert Currency

Add to Basket

Shipping: 3
From United Kingdom to U.S.A.
Destination, Rates & Speeds

9.

Bellamy, Laura
Published by IBM Press (2011)
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Paperback Quantity Available: 1
Seller
Murray Media
(North Miami Beach, FL, U.S.A.)
Rating
[?]

Book Description IBM Press, 2011. Paperback. Book Condition: New. Bookseller Inventory # 0132480522

More Information About This Seller | Ask Bookseller a Question

Buy New
43.99
Convert Currency

Add to Basket

Shipping: 2.30
Within U.S.A.
Destination, Rates & Speeds

10.

Laura Bellamy; Michelle Carey; Jenifer Schlotfeldt
Published by IBM Press (2011)
ISBN 10: 0132480522 ISBN 13: 9780132480529
New Paperback Quantity Available: 1
Seller
Irish Booksellers
(Rumford, ME, U.S.A.)
Rating
[?]

Book Description IBM Press, 2011. Paperback. Book Condition: New. book. Bookseller Inventory # 0132480522

More Information About This Seller | Ask Bookseller a Question

Buy New
46.71
Convert Currency

Add to Basket

Shipping: FREE
Within U.S.A.
Destination, Rates & Speeds

There are more copies of this book

View all search results for this book