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