Most enterprises drive their Web sites and intranets using a CMS (content management system). That’s because CMSes offer consistent branding, easy editing, content reuse, and approval workflows. Unfortunately, publishing systems for producing structured technical manuals came late to the party in delivering these benefits. Sometimes you must learn older SGML (Standard Generalized Markup Language) -- or deal with expensive and cumbersome XML editors. Astoria On-Demand sidesteps these problems with a highly usable and quickly deployed hosted system based on OASIS’ DITA (Darwin Information Typing Architecture) standard.
Fundamentally, XML-tagged documents are ideal for, say, manufacturers of complex machinery that must deliver supporting documentation. For instance, details about a commonly used part could be included in various manuals or online help systems. Astoria isn’t unique here. But, whereas other systems usually place a layer between the user interface and a relational database -- creating bottlenecks when the application tries to manage millions of links to the various content pieces -- Astoria On-Demand handles these XML objects directly. This is unusual -- and rarer for a SaaS (software as a service) solution. In my testing, this design enabled On-Demand to provide a response as fast as I’ve seen with in-house applications (typically a few seconds), even when used across DSL-speed Internet connections.
Moreover, I found using the system straightforward, after I brushed up on some DITA concepts (which should take new users a few days at most). To begin, the visual Web interface is arranged into logical areas. On the left, much like Microsoft Word’s Document Map feature, Astoria’s Map Editor structures content into standard DITA topics, references, and tasks that appear in a hierarchical tree.
Opening a task folder allowed me to easily tap other Astoria capabilities. The upper ribbon area provides quick access to 18 repository functions, including authoring and reusing objects. Collaboration is just as essential to the documentation cycle, and here Astoria On-Demand is especially strong. For example, I added annotations and attached comments to content at the element level and then triggered a workflow. The system sent an e-mail task notification along with a link to the exact section of the document that required revision or approval.
Click for larger view. |
Astoria On-Demand demystifies other complex tasks, too. For instance, Astoria Document Assembly (a built-in application) creates new documents for you from components and topics stored in the repository. Moreover, these technical bulletins, data sheets, and operator manuals are dynamically updated to reflect changes in the single copy of the underlying content. The Astoria Translation Manager is equally adept, creating versions of documents for each translated language (there’s complete UTF-8 and UTF-16 support).
Also on the publishing side, Astoria Filtered Publisher outputs
Click for larger view. |
For organizations that produce complex products and need an equally sophisticated solution to create associated documentation, Astoria On-Demand has top qualifications.
Mike Heck is a contributing editor of the InfoWorld Test Center.
Talkback
E-mail
Printer Friendly
Reprints




