- My client requires a User Manual and Online Help for an application. I add an additional 20% effort to convert a manual to help and offer him my quote. But he has a time and money constraint. He wants both the outputs in the time and effort of a single output. And I cannot say no to him for my own good. What do I do then?
- My client wants role based user manuals. Approx 40% of the content across all the manuals is the same. How can I save the effort of replicating the common content across manuals?
- I am documenting a Health Care System, which has 50 applications, which implies I have to write 50 manuals. The functionality of one application is interwoven with another. Change in functionality in one application will get applied across all applications. Do I have to affect those changes across all manuals or is there a way where I can make the change at one location and the change get applied in all manuals?
- I need to publish a Configuration guide for two different sites. The sites use the same product but the configuration values may differ for each site. Can I maintain a single source of the Configuration Guide and use conditional publishing to generate two guides with different customized configuration values?
- I have 25 Styles in the document template. My team comprises 5 writers working independently on sub tasks. My job is to consolidate all the work. I face the problem of styles and format getting corrupted in the process. Is there a remedy for this issue, where in the format and styles defined can be made tamper-proof?
- I often find it tough conveying to my team the correct structuring of a manual. Inspite of my best efforts, everyone writes based on their whims and fancies. Is there a method where I can define and fix the manual structure and ensure that my writers follow that without any ambiguity?
- My client wants me to deliver my deliverable in iterations. He wants me to deliver all the overview information first (to assess my understanding), then procedures (to check the navigation is captured correctly) and then the field level information. Can I develop content based on my client’s requirement and later easily merge the contents to create a user manual as per the application flow or task flow?
DITA is neither a software language nor a documentation tool; it is an architecture that provides us a simple and flexible way of developing and managing content. It follows the basics of technical writing, that is, topic based writing.
One of the most powerful languages in the information industry, XML, is the foundation of DITA. Industry trends indicate clearly that XML is going to be the future of technical communication. Some of the most prominent authoring tools are making their transition into XML, namely MS word 2007, RoboHelp 9, and Frame Maker 10. In future posts on DITA, you will be guided through the following sections:
- DITA Overview – Definition of DITA with the basic concepts.
- DITA Characteristics – Features of DITA that provides flexible way to develop and manage content.
- DITA Implementation Principle – The complete flow and involved technologies.
- DITA User Classification – User expertise required to adopt the architecture.
- DITA Framework – Complete Guide to implement content authoring and publishing in DITA.
No comments:
Post a Comment