Preface to CMS Software Documentation

Complete: 4



This documents gives an overview of the CMS Software documentation. It is based on the CMS Software documentation policy which defines the general structure of the CMS Software documentation, and the different actors and their responsibilities in the documentation and its maintenance.

CMSSW documentation suite

The CMSSW documentation consists of three main elements: The WorkBook contains the instructions on accessing computing resources and using the software to perform analysis within the CMS collaboration.

The Offline SW Guide gives full details of CMS Software including description of algorithms and software architecture, instructions for analysis and validation and common items such as developers’ guide, trouble shooting guide, FAQ lists, and instructions for code optimization.

The Reference Manual contains the release dependent technical documentation such as class lists, brief description of content and purpose of each package and default configuration files and sequences.

How to use the documentation

Using the WorkBook page explains how to get the most out of the WorkBook. The reader will learn what the various symbols and links on the workbook pages mean, what type of information they link to, who to contact about a given page, and how to provide feedback to the editors. A similar page should be provided for the Offline Guide.

A brief introduction to the Reference Manual use is given in WorkBookHelp#RefMan.

Review status

Reviewer/Editor and Date (copy from screen) Comments
KatiLassilaPerini - 22 Oct 2007 created page

Responsible: KatiLassilaPerini
Last reviewed by: Most recent reviewer

Edit | Attach | Watch | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r3 - 2007-11-26 - KatiLassilaPerini

    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    CMSPublic All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback