Open Text Corporation

Open Text is a leading provider of enterprise content management solutions.

Integration manual for administrators

Customer

Open Text Corporation

Project duration

2013

Project goals

Acting as support for the in-house technical writing group, we were asked to write an English guide for administrators and software engineers that explains the integration of different web content management servers.

Approach and methods

The technical writing group of Open Text Corporation produces documentation for various products in multiple languages. They use an XML-based content management solution and the Arbortext Editor to ensure content quality and uniform structures. A style guide ensures linguistic consistency.

Our extensive experience with XML-based documentation enabled us to quickly become familiar with the content management system. After a short introduction to the web content management servers, we collaborated with product management to design a structure for the manual. We provided these services:

  • Gathering information from internal specifications, interviews with software engineers, and tests in virtual server environments, to use in the new guide
  • Designing the structure of the new guide
  • Writing the topics according to the principles of functional design (Funktionsdesign), that is, classified as task topics, conceptual descriptions, and reference information

Insight

Architecture image illustrating the publishing workflow

screenshot modulstreifen ot

  • facebook
  • linkedin
  • xing