tag:blogger.com,1999:blog-1520346663771309945.post2981190835517152510..comments2023-02-14T18:15:25.680+05:30Comments on Writing Technically: Quick and rude guide to DITA - Part 1 of 3Anindita Basuhttp://www.blogger.com/profile/03352360406165885914noreply@blogger.comBlogger3125tag:blogger.com,1999:blog-1520346663771309945.post-1283334745913676412010-01-25T16:36:43.603+05:302010-01-25T16:36:43.603+05:30Anindita,
Please clarify me, Is this what my unde...Anindita,<br /><br />Please clarify me, Is this what my understanding say as minimalism and Information Mapping?....<br /><br />Kind Regards<br />Bijoy Raj GuhaBijoy Raj Guhahttps://www.blogger.com/profile/04792605391648136702noreply@blogger.comtag:blogger.com,1999:blog-1520346663771309945.post-86707718691452187432010-01-18T21:39:07.315+05:302010-01-18T21:39:07.315+05:30:) Yep, it's awful! That's the very reaso...:) Yep, it's awful! That's the very reason I put it up here - so that people can immediately start thinking, "Hey, what's a concept - or reference - doing in the middle of a task?"Anindita Basuhttps://www.blogger.com/profile/03352360406165885914noreply@blogger.comtag:blogger.com,1999:blog-1520346663771309945.post-33289225897561563162010-01-18T21:35:33.104+05:302010-01-18T21:35:33.104+05:30Sorry to say, but the linked user guide is quite a...Sorry to say, but the linked user guide is quite an awful example for topic-based authoring. Look at the table of contents and try to count the task topics. <br /><br />"Using the Power Defrost Feature" is NOT a task, but a poorly written topic that focuses on product features instead of tasks. The task is "Defrost food" or "Defrosting food".<br /><br />And don't get me started on the other issues, such as inconsistent use of "please", inconsistent use of "important" and "note" icons, warnings at the end of topic after a page break, camel case capitalisation in headings...Kainoreply@blogger.com