In recent years Extensible Markup Language (XML) has had a major impact on software development and data interchange and has begun to have a similar effect in technical communication. XML provides a platform-independent, vendor-neutral source language for publishing documentation of all kinds and in any output format. XML solutions have already been adopted by many technical publication departments, while others are poised to make the move to XML. Authoring tools, publishing tools and content management systems are providing support for XML languages, in particular Darwin Information Typing Architecture (DITA), one of the XML languages designed specifically for technical documentation. Increasingly, technical communicators therefore need to understand what XML has to offer and how it can be used in the various areas of technical communication. This book fills an important gap in the market by providing a broad introduction to XML and its role in technical communication. It describes the basics of XML syntax and terminology, the use of XML in technical communication and the advantages it can bring to the production of technical documentation of all types. It introduces the key XML languages that are used for technical documentation, both as documentation source formats and for transforming source documents to various output formats. The book will be invaluable to anyone who needs a fast introduction to XML and its role in technical communication, such as those whose organization is deploying an XML-based documentation solution, or freelancers who need to keep pace with technical trends. It caters for technical communicators of all levels of markup language experience, providing acomprehensive yet easy to read overview of the use of XML in technical communication, as well as references to more in-depth material. Charles Cowan FISTC is a Principal Technical Writer with the Oracle Corporation. He has worked as a technical communicator for over a quarter of a century, developing documentation for various clients and software companies in Belgium, Germany and Switzerland, as well as in the UK and Ireland. He is an IBM Certified Developer in XML and Related Technologies and holds postgraduate qualifications in computing and software development.
Miller, Dick R., and Kevin S. Clarke. Putting XML to Work in the Library: Tools for Improving Access and Management. Chicago: American Library Association, 2004. OASIS. “The Simplified DocBook Document Type.” 2004.
The Language of Technical Communication
SAS Press The IBM Style Guide: Conventions for Writers and Editors By Francis DeRespinis, Peter Hayward, Jana Jenkins, Amy Laird, Leslie McDonald, Eric Radzinski IBM Press Microsoft Manual of Style By Microsoft Corporation Microsoft ...
The book describes a methodology that covers the different phases of the content and metadata management lifecycle, from generation, to archiving, to compliance with existing content management and archiving standards.
The choice of terms defined in this book followed two overarching principles: include all aspects of the discipline of technical communication, not just technical writing, and select terms that will be relevant into the foreseeable future.
Cross-indexing. Not everyone thinks exactly alike, and your index should anticipate this. By including variations of an entry, you can make sure that different readers find the information they need. (Professional indexers refer to ...
Every Page is Page One shows technical communicators how to document a large and complex product using only topics and enable readers to find and navigate topic-based content effectively.
Informal overview From the perspective of hardware resources, the fields of speech systems and multimodal systems are highly complex, ... Speech and visual communication resources also Resources for technical communication systems 271.
Writing better computer user documentation. From paper to hypertext. Version 2.0. New York: Wiley. Brockmann, R. J. (1998). From millwrights to shipwrights to the twenty-first century. Creskill, NJ: Hampton Press. Bruck, B. (1999).
... and Exam Prep, 6th Edition Baklarz, Zikopoulos ISBN: 0-13-185514-X Lotus Notes Developer's Toolbox Elliott ISBN: 0-13-221448-2 IBM Lotus Connections 2.5 Planning and Implementing Social Software for Your Enterprise Hardison, Byrd, ...