How XML Enables Information Sharing and Reuse — Interview with Joe Gollner

XML, a way of tagging and structuring your content, can help solve a number of problems, including storing, mining, reusing, and sharing content. XML helps enable the interoperability of information between systems, allowing you to export and import your content from one application to another. XML is behind much of the collaboration and information sharing Web 2.0 technologies, such as RSS (really simple syndication) and blogs. By storing content in XML, technical writers can ensure greater flexibility among technologies for authoring and publishing their content.

Gollner, Joe and Tom H. Johnson. Tech Writer Voices (2008). Articles>Interviews>Content Management>XML

httplib2: HTTP Persistence and Authentication

In this latest Restful Web column, Joe Gregorio explains HTTP persistent connections, pipelining, and the sad state of HTTP authentication.

Gregorio, Joe. XML.com (2006). Articles>Web Design>XML>Security

Implementing Information Architecture Using XML: A Business-Driven Approach

A few of aspects that are easy to miss in the excitement of trying to implement an XML-based information architecture in an organization.

Pant, Asit H. and Aoyon Choudhary. Indus (2005). Articles>Information Design>XML

Implementing the Atom Publishing Protocol

Joe Gregorio's latest Restful Web column implements the Atom Publishing Protocol as a Python web service using WSGI.

Gregorio, Joe. XML.com (2006). Articles>Information Design>XML>RSS

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

The Implications of Single Sourcing for Technical Communicators    

Surveys four books that examine methods of single sourcing, including publishing tools, XML, and content management systems. Reviews articles describing the roles of writers and editors, the tool set and its implementation, and ways to make dynamic content more effective

Williams, Joe D. Technical Communication Online (2003). Articles>Content Management>Single Sourcing>XML

Review: Information Architecture With XML: A Management Strategy

Despite the plethora of books positioning Extensible Markup Language (XML) as the next software programming language for IT gurus to master, the XML specification is not a programming language. Instead, it is a set of strategically important data standards that, when implemented from a tactical point of view, can provide organizations with value unsurpassed by many of the technologies that have come before it.

Abel, Scott. STC Hoosier (2003). Articles>Reviews>Information Design>XML

Information Models and XML  

The defining feature of XML is the ability to specify your own tags. Learn about what to look for in an XML information model and what a technical communicator can contribute to an XML documentation team.

Baril, France. Intercom (2006). Articles>Information Design>XML

An Introduction to DITA

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

Inline XML

I was sitting at my desk a few days ago, whiling away the time and I suddenly wondered why HTML includes a <code> tag, and a <var> tag, and yet it takes marking up code no further than that. It’d be understandable to have just the <code> tag, but if they’re going to have a <var> tag, shouldn’t they have more programming tags?

Cannon, Lachlan. List Apart, A (2002). Design>Web Design>XML

Integrating Partner Information Using XML and XSL  

BMC Software Inc., a company that writes utility tools for database administrators, wanted to reuse the error messages from partner database companies. 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 product.

Gentle, Anne. STC Proceedings (2004). Articles>Information Design>XML>XSL

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

Introducing SOAP

SOAP or Simple Object Access Protocol has become a standard mechanism in the world of Web Services. Now what exactly does this mean? And how can I make use of it inside Acrobat?

Wraight, Dave. PlanetPDF (2004). Design>Information Design>XML>SOAP

Introducing XML Internationalization

One key benefit of XML is the fact that it was designed for international use. But do you really understand the concepts of internationalization and localization? This article explains what they are, how they work, and why you want to use them.

Silberman, Hernan. IBM (2007). Articles>Information Design>XML>International

Introduction to DITA References

DITA is quickly becoming the dominant XML schema for topic-oriented authoring. DITA is a highly practical way of moving to XML authoring in general and granular content reuse in particular. DITA distinguishes itself from predecessor standards by explicitly rejecting the book paradigm in favour of a topic-oriented model.

Prescod, Paul. IDEAlliance (2004). Articles>Information Design>XML>DITA

An Introduction to Extensible Stylesheet Language  

Introduces the three technologies that comprise the Extensible Stylesheet Language (XSL) family of specifications as defined by the World Wide Web Consortium (W3C).

Hodge, Drew W. Intercom (2004). Articles>Information Design>XML>XSL

Introduction to OMG's Unified Modeling Language (UML)

Large enterprise applications - the ones that execute core business applications, and keep a company going - must be more than just a bunch of code modules. They must be structured in a way that enables scalability, security, and robust execution under stressful conditions, and their structure - frequently referred to as their architecture - must be defined clearly enough that maintenance programmers can (quickly!) find and fix a bug that shows up long after the original authors have moved on to other projects. That is, these programs must be designed to work perfectly in many areas, and business functionality is not the only one (although it certainly is the essential core). Of course a well-designed architecture benefits any program, and not just the largest ones as we've singled out here. We mentioned large applications first because structure is a way of dealing with complexity, so the benefits of structure (and of modeling and design, as we'll demonstrate) compound as application size grows large. Another benefit of structure is that it enables code reuse: Design time is the easiest time to structure an application as a collection of self-contained modules or components. Eventually, enterprises build up a library of models of components, each one representing an implementation stored in a library of code modules. When another application needs the same functionality, the designer can quickly import its module from the library. At coding time, the developer can just as quickly import the code module into the application.

UML Resource Page (2005). Articles>Information Design>XML>UML

Introduction to Relations in XML Schema

This is the first article in a series concentrating on implementing relations for designing robust XML schema definitions.

Chaterjee, Jagadish. Dev Articles (2006). Articles>Information Design>Databases>XML

Introduction to RSS

Really Simple Syndication (RSS) is an XML format for news headlines. With RSS-enabled feeds, other web sites can easily include your content in their sites. And other applications (besides web browsers) can be used to view your content.

Duffy, Scott. XGuru (2003). Articles>Web Design>XML>RSS

Introduction to the Darwin Information Typing Architecture (DITA)

The Darwin Information Typing Architecture (DITA) is an XML-based, end-to-end architecture for authoring, producing, and delivering technical information. This architecture consists of a set of design principles for creating 'information-typed' modules at a topic level and for using that content in delivery modes such as online help and product support portals on the Web. This document is a roadmap for DITA: what it is and how it applies to technical documentation.

IBM (2001). Articles>Information Design>XML>DITA

Introduction to XML

XML, the Extensible Markup Language, has gone from the latest buzzword to an entrenched eBusiness technology in record time. This newly revised tutorial discusses what XML is, why it was developed, and how it's shaping the future of electronic commerce. It also covers a variety of important XML programming interfaces and standards, and ends with two case studies showing how companies are using XML to solve business problems.

Tidwell, Doug. IBM (2002). Resources>Education>Information Design>XML

Introduction to XML Document Object Model

Learn about XML and the hierarchical structure of the Document Object Model. Nodes, NodeLists, NameNodeMaps, as well as properties such as parentNodes, childNodes, nodeNames, and nodeValues are explored, explained and code is given.

Gokul, Gayathri. ASP Free (2002). Articles>Information Design>XML

Introduction to XML for Technical Writers  

XML is still the hot technology for technical writing. New XML tools are being delivered at a fast pace Every day, there are new XML initiative being announced. But when you try to learn about this exciting new technology, when you review the many books that are appearing on shelves, or sites popping up on the Web, you'll find that the information that is available is mostly aimed at developers. This session focuses on the value that it brings to technical writers and their users, and will include code samples.

Manning, Steve. STC Proceedings (2002). Design>Web Design>XML>Technical Writing

Introduction to XML for Web Developers

Using simple, well-explained examples this tutorial walks you through XML and the sister XSL style sheet language.

Sol, Selena. WDVL (1999). Design>Web Design>XML>XSL

Introduction to XML for Web Developers

Surely, if you have decided to learn about XML, you are probably already quite familiar with the concepts behind HTML (HyperText Markup Language). So let's start from there.

Extropia. Design>Web Design>XML