Mar 21 – 27, 2009
Europe/Prague timezone

Improving collaborative documentation in CMS

Mar 24, 2009, 8:00 AM


Prague Congress Centre 5. května 65, 140 00 Prague 4, Czech Republic
Board: Tuesday 081
poster Collaborative Tools Poster session


Kati Lassila-Perini (Helsinki Institute of Physics HIP)


Complete and up-to-date documentation is essential for efficient data analysis in a large and complex collaboration like CMS. Good documentation reduces the time spent in problem solving for users and software developers. The scientists in our research environment do not necessarily have the interests or skills of professional technical writers. This results in inconsistencies in the documentation. To improve the quality, we have started a multidisciplinary project involving CMS user support and expertise in technical communication from the University of Turku, Finland. In this paper, we present possible approaches to study the usability of the documentation, for instance, usability tests conducted recently for the CMS software and computing user documentation.

Primary author

Kati Lassila-Perini (Helsinki Institute of Physics HIP)


Leena Salmi (University of Turku, Finland)

Presentation materials