| |||||||||
|
1. #27076 Adobe Systems Speaks Out on DITA: Internal use of FrameMaker, CMS, and DITA Asks Puny Sen, Project Lead, Instructional Communications at Adobe Systems to talk about the software giant's foray into the world of the Darwin Information Typing Architecture (DITA). Sen shares details about Adobe's recent DITA documentation project, the pro's and con's of using DITA with FrameMaker, as well as lessons learned of importance to anyone interested in adopting the DITA standard. Ethier, Kay and Scott Abel. Bright Path Solutions (2005). Articles>Documentation>XML>DITA 2. #25378 An Overview of Single Sourcing with an XML Content Management System Creating an XML-based Content Management System to single-source technical publications is as simple as 1 - 2 - 3. OK, maybe it isn't quite that easy, but this article discusses how it can be done. Sapir, Rick. KeyContent.org (2004). Articles>Content Management>Documentation>XML 3. #30230 Build-to-Order Documents with DITA It is entirely possible to deliver custom, on-demand documentation that is precisely suited to a user's needs. It can be done today, using web-interface strategies and the right document format. This post shows how such a system could be implemented with the DITA format, and shows why it would be an ideal document-delivery system for programmers. Armstrong, Eric. Sun Microsystems (2007). Articles>Documentation>XML>DITA 4. #29635 By organizing information around the goals that users are trying to accomplish, you can provide task-based information that truly addresses user needs. This article walks through the steps for creating more useful information navigation by implementing information development best practices with examples in the Darwin Information Typing Architecture (DITA). Swope, Amber and Michael Priestley. STC Proceedings (2005). Articles>Documentation>XML>DITA 5. #27075 Darwin Information Typing Architecture (DITA) The purpose of this research note is to introduce the Darwin Information Typing Architecture (DITA) and highlight its relationship to other information architectures like DocBook and Information Mapping. Namahn (2005). Articles>Documentation>XML>DITA 6. #29971 Can DITA be used as a Help authoring technology? Superficially, of course it can! The DITA Open Toolkit includes an HTML Help transformer, an Eclipse Help transformer, and an HTML transformer (which can also generate some sort of Table of Contents). So isn't it obvious then? DITA is perfect for Help authoring. Or is it? Looking a bit deeper, it's not so obvious. Can I include context-hooks in my content? Can I specify a popup link? Can I build a modular Help system? If I can't, then DITA is probably not suitable for Help. Self, Tony. HyperWrite (2007). Articles>Documentation>XML>DITA 7. #29972 Two of the oft-quoted benefits of DITA, the Darwin Information Typing Architecture, are 'single-sourcing' and 'content re-use'. These benefits do not only apply to the commonly-accepted definition of technical documents, but to many other forms of documents from outside the technical communicator's realm. Self, Tony. HyperWrite (2007). Articles>Documentation>XML>DITA 8. #26373 This howto attempts to clear the fog and mystery surrounding the DocBook markup system and the tools that go with it. It is aimed at authors of technical documentation for open-source projects hosted on Linux, but should be useful for people composing other kinds on other Unixes as well. Raymond, Eric S. tldp.org. Articles>Documentation>XML>DocBook 9. #21657 The issue of documenting schemas—or any machine readable language—goes beyond simple additions of comments. Thereal challengeistocreateschemasthat arereadablebothdirectlybylookingat their sourcecodeandbydocumentation extraction tools. van der Vlist, Eric. O'Reilly and Associates (2001). Articles>Information Design>XML>Documentation 10. #29081 This article describes the influence that Extensible Markup Language (XML) will have on the software documentation process and subsequently on the curricula of advanced undergraduate and master's programs in technical communication. XML, an evolving set of standards for storing and displaying information, uses nine components that make up the XML development process. Grouped into content, formatting, and language specifications, these components enhance organizations' ability to manage information more efficiently and accurately. As the XML development process is adopted, the software documentation process will evolve from a self-contained procedure into a more flexible, interactive process in which software documenters must work closely with a wide range of specialists. The changes that XML will have on the software documentation process will likewise have implications for programs in technical communication in the need to address new kinds of job descriptions, skill sets, and career paths of future technical communicators. The article recommends adaptations to existing courses, as well as new elective and required courses. Battalio, John T. Journal of Technical Writing and Communication (2002). Articles>Documentation>Education>XML 11. #25444 This chapter is intended to provide a quick introduction to structured markup (SGML and XML). If you're already familiar with SGML or XML, you only need to skim this chapter. To work with DocBook, you need to understand a few basic concepts of structured editing in general, and DocBook, in particular. That's covered here. You also need some concrete experience with the way a DocBook document is structured. Walsh, Norman and Leonard Muellner. O'Reilly and Associates (1999). Articles>Documentation>Standards>XML 12. #27740 Getting Started with the DocBook XML Dialect Gets you started with DocBook, an SGML/XML dialect that describes the content of technical articles and other documents. David discusses the benefits of using DocBook, and then describes how to plan and modularize a large document conversion project. Mertz, David. IBM (2000). Articles>Documentation>XML>DocBook 13. #14781 Implementing XML: A Writer's Perspective In the cover article for Intercom's special issue on XML and HTML, Conlin discusses how the implementation of XML affects writers of documentation. Conlin, Karen E. Intercom (2002). Articles>Documentation>XML 14. #28230 Writing, compiling, and maintaining documentation is a necessary evil. While moving to DITA might not improve the quality of your documentation, it can streamline the process of creating and managing those documents. Nesbitt, Scott. InformIT (2006). Articles>Documentation>XML>DITA 15. #28775 Integrating Partner Information Using XML and XSL Having learned that two of these database companies already used single-source files for their error messages, BMC Software integrated the information about the error messages from the database companies. We accomplished our goal by negotiating with our partner companies for the source files of the error message information. This session discusses how we took those source files and modified them to create simple XML files, then transformed them into HTML using XSL transforms within a BMC Software product. Gentle, Anne. WritersUA (2006). Articles>Documentation>XML>Case Studies 16. #22621 Managing and Documenting Your Project, XML Style Here are links to the listings described in Managing and Documenting Your Project XML Style. Fisher, Timothy. XML Journal (2003). Articles>Documentation>Project Management>XML 17. #28185 Structured Authoring and XML: Part One Implementing structured authoring with XML allows organizations to create better content. The addition of hierarchy and metadata to content improves reuse and content management. These benefits, however, must be weighed against the time and money required to implement a structured authoring approach. The business case is compelling for larger writing organizations; they will be the first to adopt structured authoring. Over time, improvements in available tools will reduce the cost of implementing structured authoring and make it affordable for smaller organizations. O'Keefe, Sarah S. Carolina Communique (2003). Articles>Documentation>Information Design>XML 18. #28177 Structured Authoring and XML: Part Three Not every content-creation group will benefit from structured authoring and XML. Sometimes, the expense of implementation outweighs the benefits realized, especially in smaller groups with less total page count. O'Keefe, Sarah S. Carolina Communique (2004). Articles>Documentation>Information Design>XML 19. #28186 Structured Authoring and XML: Part Two In a structured authoring environment, authors create documents by assembling elements and text in an order permitted by the structure definition document. You might think of structured authoring as being similar to template-based authoring with a strict template. Authors do not assign formatting; the formatting is automatically assigned based on the structure of the document. Formatting may differ for different output media. O'Keefe, Sarah S. Carolina Communique (2003). Articles>Documentation>Information Design>XML 20. #24025 Three Ways of Using XML in Software User Assistance Technical writers are gearing towards challenging roles that enable them to enrich software users' experience. Extensible Markup Language (XML) happens to be one of the ways in which writers are enhancing their skills for software user assistance. Ryali, Kavita. STC Puget Sound (2004). Articles>Documentation>XML>Help 21. #29342 Tips for Documenting an XML DTD XML-based development projects often require the development of a Document Type Definition (DTD), which defines the XML code used in an XML document or application. Even if you are customizing an existing DTD like the DocBook DTD, documenting the DTD is a best practice for a number of reasons, including:Providing documentation Kelly, William T. TechRepublic (2003). Articles>Documentation>Programming>XML 22. #21709 XML provides a robust, non-proprietary, and verifiable file format for the storage and transmission of text and data both on and off the Web. XML removes the complexity of SGML, making it easier to define your own document types, and to write programs to handle them. Bokil, Manoj. STC India (2003). Articles>Documentation>Information Design>XML 23. #28263 XML Architecture for Customized User Assistance Content reuse enables technical communicators to create multiple deliverables from a single set of source documents. A key component of reuse is identifying which information belongs in which deliverable. Some customization is feasible with build tags (RoboHelp), conditional text (FrameMaker), topic reuse (FrameMaker and AuthorIT), and similar features. O'Keefe, Sarah S. WritersUA (2005). Articles>Documentation>XML 24. #27640 An XML Architecture for Technical Documentation: The Darwin Information Typing Architecture DITA is an architecture for creating topic-oriented, information-typed content that can be reused and single-sourced in a variety of ways. It is also an architecture for creating new information types and describing new information domains, allowing groups to create very specific, targeted document type definitions using a process called specialization, while at the same time reusing common output transforms and design rules. We discuss several methods that can be used to extend DITA's basic topic types. Day, Don, Erik Hennum, John Hunt, Michael Priestley, David Schell and Nancy Harrison. WritersUA (2004). Articles>Documentation>XML>DITA 25. #26313 In our Schema tutorial, you will learn what an XML Schema is, how XML Schema will replace DTD, and how to use the XML Schema language in your applications.
| |||||||||
| |||||||||
Click here to learn how to embed the RSS feed of this category in your website.