Re—usable Templates for Documenting the Elaboration and Architectural Design of the CMS Software

Modern standards and definitions of deliverables for software development are provided by by various standards like PSS-05,CMMI,ECSS,V,Rational Unified process or SPICE(ISO 15504),Modern document templates and the corresponding documents are based on atomic shells that cross-link,and can be subsequently assembled into a set of complete documents;views of the information in the shells.This makes the information easy to maintain,and enables selective views of the documentation.We will present a catalogue of document templates that has been developed in the context of the CMS CAFE forum,as well as their cross-linkage,using UML as the modelling language The templates allow for documenting the elaboration and architectural design phases of software development,They can be used as the basis for establishing and documenting architecture,while establishing trace-ability to use-cases,requirements,constraints,and important technological choices in a maintainable manner.