Deliver to your Kindle or other device

 
 
 

Try it free

Sample the beginning of this book for free

Deliver to your Kindle or other device

Anybody can read Kindle books—even without a Kindle device—with the FREE Kindle app for smartphones, tablets and computers.
DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA (IBM Press)
 
 

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

Laura Bellamy , Michelle Carey , Jenifer Schlotfeldt
4.5 out of 5 stars  See all reviews (2 customer reviews)

Print List Price: £29.99
Kindle Price: £20.89 includes VAT* & free wireless delivery via Amazon Whispernet
You Save: £9.10 (30%)
* Unlike print books, digital books are subject to VAT.

Formats

Amazon Price New from Used from
Kindle Edition £20.89  
Paperback £29.99  
Kindle Daily Deal
Kindle Daily Deal: At least 60% off
Each day we unveil a new book deal at a specially discounted price--for that day only. Learn more about the Kindle Daily Deal or sign up for the Kindle Daily Deal Newsletter to receive free e-mail notifications about each day's deal.

Customers Who Bought This Item Also Bought


Product Description

Product 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

From the Back Cover

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

Product details

  • Format: Kindle Edition
  • File Size: 11617 KB
  • Print Length: 288 pages
  • Simultaneous Device Usage: Up to 5 simultaneous devices, per publisher limits
  • Publisher: IBM Press; 1 edition (1 Aug 2011)
  • Sold by: Amazon Media EU S.à r.l.
  • Language: English
  • ASIN: B005FEOU48
  • Text-to-Speech: Enabled
  • X-Ray:
  • Average Customer Review: 4.5 out of 5 stars  See all reviews (2 customer reviews)
  • Amazon Bestsellers Rank: #380,085 Paid in Kindle Store (See Top 100 Paid in Kindle Store)
  •  Would you like to give feedback on images?


More About the Author

Discover books, learn about writers, and more.

What Other Items Do Customers Buy After Viewing This Item?


Customer Reviews

3 star
0
2 star
0
1 star
0
4.5 out of 5 stars
4.5 out of 5 stars
Most Helpful Customer Reviews
1 of 1 people found the following review helpful
4.0 out of 5 stars Are the errors deliberate? 9 Jan 2013
By IanB
Format:Paperback|Verified Purchase
Amazing number of errors from typos to just the wrong picture. But don't let the errors drive you away from this book. There's a pragmatic approach that should help enormously many first time users. DITA techniques are well described and for the most part easy to follow. There are some odd areas where there's a promising title and then almost no usable substance - for example using templates or external non-DITA files.

I got to page 70 or so before I started to understand the additional text string call outs and boxes in the editor screen shots. A "how to read the pictures" section in the front matter would have helped. The page layout does not help remove the impression that XML can be ugly.

Maybe the errors are deliberate - just to keep your attention. It seems beyond belief that anyone could publish such a book with such beginner errors spread throughout if the errors were not there to tell us - even the experts get it wrong, so there's hope for you.

Checklists at the end of each chapter are particularly useful. The chapter on legacy conversion is a great asset. However, the repetitive structure of every chapter drags after a while. Or perhaps it was not meant to be read from front to back - just dip in for reference. Whatever your position around a DITA project, read this book, have a giggle over the errors, then just remember to use the good stuff.

Last point - I think the authors should have tried harder to follow their own advice. There are quite a few examples of content or structure contradicting advice elsewhere in the book. Navigation can be difficult as well with at one point Step 4 following 20 pages after Step 3.

Still - get the book - you'll enjoy it and benefit from having read all of it.
Comment | 
Was this review helpful to you?
5.0 out of 5 stars A comprehensive guide to DITA 17 Oct 2013
Format:Paperback|Verified Purchase
If you're looking to learn DITA, this is the best book in the market right now. I read a few others but none are as comprehensive as this one.
Comment | 
Was this review helpful to you?
Most Helpful Customer Reviews on Amazon.com (beta)
Amazon.com: 4.1 out of 5 stars  7 reviews
7 of 8 people found the following review helpful
5.0 out of 5 stars Best DITA how to book for tech docs yet 11 Oct 2011
By Yvonne Kucher - Published on Amazon.com
Format:Paperback|Verified Purchase
This book really is the definitive DITA roadmap and best practices based on many years of experience.

The book also includes:
- Chapter summaries
- Checklists and worksheets
- Common problems and solutions
- Figures and tables of correct and incorrect how tos

Although you can access the book immediately if you join Safari books, buy the printed book too because of its visual effectiveness. What do I mean? You'll find out!
4 of 4 people found the following review helpful
5.0 out of 5 stars Get this book! 27 Oct 2011
By J. Chew - Published on Amazon.com
Format:Kindle Edition
Anyone who is implementing or using DITA should get this book. It has everything that you need to know to implement and use DITA.

This is now my go-to DITA book and has replaced the other DITA books and information (for example, material from DITA classes) that I already have.
1 of 1 people found the following review helpful
5.0 out of 5 stars A Must Read -- Even at the Beach 20 April 2014
By AlQibla AlAwla - Published on Amazon.com
Format:Paperback|Verified Purchase
We have six large publications and eight customers, all of whom want a customized version. This situation cries out for single sourcing, for which DITA is one solution. The online documentation for DITA is OK, but not comprehensive, not always comprehensible, and not necessarily addressed to technical writers. This publication is all three. Extremely well planned, very logical structure, and the authors have clearly spent many hours doing the job that I do. If you have a gut feeling that DITA can solve your single-sourcing problem, but are not sure exactly how, then this book is for you.
5.0 out of 5 stars One of the best books in DITA you can get 6 Jun 2014
By Diane L. Thompson - Published on Amazon.com
Format:Paperback|Verified Purchase
If you are embarking on DITA, arm yourself with lots of knowledge going in. If you can only afford one book on the subject, this should probably be the one. The book thoroughly covers Topic-based authoring, a necessity when working with DITA (or actually for all tech writers), including such concepts and minimalist writing and content sharing. After grounding you in all the types of topics, the next section deals with the architecture of DITA content: maps, linking, content reuse, and like that. The last section covers converting DITA into whatever output format you are using. It goes further into editing both the DITA code and the final content.

I have probably six books on DITA. I have gained something from all of them, either practically or philosophically but this one covers the most and covers it well.
5.0 out of 5 stars Excellent overview of DITA 5 Jun 2014
By Priya Hays - Published on Amazon.com
Format:Paperback|Verified Purchase
DITA Best Practices gives a detailed overview of the technical aspects of DITA. Written for beginners and experts, the book discusses the use of topics, the reuse of content allowed by DITA, and how and why DITA should be adopted by companies. I use DITA at work, and this book gave me the theoretical insight into the practical use of DITA. It does a great job of clarifying difficult concepts such as information modeling.
Were these reviews helpful?   Let us know
Search Customer Reviews
Only search this product's reviews

Popular Highlights

 (What's this?)
&quote;
Distinguish concept topics from task topics by using noun-based titles for concept topics and verb-based titles for task topics. &quote;
Highlighted by 4 Kindle users
&quote;
Write one step per significant action and combine short, simple steps. &quote;
Highlighted by 4 Kindle users
&quote;
To create effective task-oriented information, follow these guidelines: &quote;
Highlighted by 4 Kindle users

Customer Discussions

This product's forum
Discussion Replies Latest Post
No discussions yet

Ask questions, Share opinions, Gain insight
Start a new discussion
Topic:
First post:
Prompts for sign-in
 

Search Customer Discussions
Search all Amazon discussions
   


Look for similar items by category