Unifying documentation teams

ABSTRACT

This paper describes how a set of geographically and organizationally distributed documentation teams created the Rational Suite 1.0 documentation set. The paper covers the business operations of Rational Software, details the documentation tools and technologies used in the project and describes the evolution of the larger team as it learned how to work with a new software development methodology. The paper concludes with a summary of lessons learned and next steps.

REFERENCES

• 1: San Jose Mercury News, April 18, 1999
• 2: "Developing a User-Information Architecture for Rational's ClearCase Product Family Documentation Set", Mary Utt and Robert Mathews, SIGDOC '99 proceedings.
• 3: Philippe Kruchten, The Rational Unified Process: an introduction, Addison-Wesley Longman Publishing Co., Inc., Boston, MA, 1999

INDEX TERMS

Primary Classification:
  D. Software
  D.2 SOFTWARE ENGINEERING
      D.2.7 Distribution, Maintenance, and Enhancement
          Subjects: Documentation

Additional Classification:
  D. Software
  D.2 SOFTWARE ENGINEERING
      D.2.9 Management
          Subjects: Programming teams

  K. Computing Milieux
  K.1 THE COMPUTER INDUSTRY
      Subjects: Standards
  K.6 MANAGEMENT OF COMPUTING AND INFORMATION SYSTEMS
      K.6.3 Software Management
          Subjects: Software development

General Terms:
Design, Documentation, Management, Performance, Standardization, Theory

Keywords:
distributed teams, documentation standards, organizational development