CERN Accelerating science

Workplan 2015

2015 Work Plan

The 2015 Work Plan is divided into three categories, with responsible members and approximate deadlines (end of calendar-year quarters) listed. Most of the items shown are carried over from 2014 (deadlines shown in bold.

  1. Documentation Structure
  2. Documentation Content
  3. Web Site Content

Last updated: 28 January 2015


Documentation Structure

 

Task Responsible Due
Remove layer of SVN repository (move DocBookUsersGuides subdirectories directly under UserDoc). Kelsey 1Q
Identify separable parts of Physics Manual, provide top-level XML to generate multiple "books" for each chapter, in addition to the single document. Can EM be split into two or more parts? Kelsey 2Q
Identify separable parts of App.Dev., provide top-level XML to generate multiple "books" as above. Can Tracking and Physics be split into two or more parts?   2Q

Documentation Content

Task Responsible Due
Produce a documentation Style Guide (or point to example chapter properly formatted) to support members and developers in contributing to the XML documentation in a consistent format. Kelsey, Ivana 2Q
Provide documentation for QMD in Physics Reference Manual: MC 2012 slides, proceedings T. Koi DONE 28 Jan 2015
Provide Transportation section of Application Developer's Guide J. Apostolakis (to be confirmed) 2Q
E-mail query 15-Jan-2015
Expand the Neutron HP section of Physics to include charged particle interactions P. Arce 2Q
E-mail query 15-Jan-2015
Toolkit Guide is incomplete, many of the UML diagrams are out of date. Should it be updated, replaced, or abandoned? Do current developers still make use of it?
WG coordinators solicited to update their sections, but very limited response. Maybe need concentrated effort ("documentation standdown") to get it finished and stop bugging people?
D. Wright 2Q
Unify markup of source code entities (classes, functions, parameters): bold, monospace, whatever, but should be the same all the way through. Maybe define a content-oriented markup tag (a la "<Code>" in HTML) to be used throughout? All 3Q

Web Site Content

Task Responsible Due
Investigate migration of Web site to modern content management system, such as Drupal at CERN. Includes investigating capability to provide protected/internal Web areas and public/unprotected areas, along with continued Web access to tags database. G. Folger, Kelsey 2Q
Task Responsible Due
(Steering Board Action Item 75.10) Expand Web pages of publications, validation results, and external citations, per suggestion from 2012 external review. Kelsey, Wright Ongoing