ATLAS S&C Documentation Workshop

Europe/Zurich
40/S2-D01 - Salle Dirac (CERN)

40/S2-D01 - Salle Dirac

CERN

115
Show room on map
Davide Costanzo (University of Sheffield (GB)), Torre Wenaus (Brookhaven National Laboratory (US))
Description

The documentation toolset (both narrative and code documentation) has been growing rapidly in the open source world. This workshop is to help ATLAS identify promising directions and tools to pursue, within the context of preserving adequate stability, continuity and preservation of investment in the existing documentation.

For information and to provide advance input (much appreciated) see the whiteboard document linked below.

    • 09:00 09:10
      Introduction 10m
      Speakers: Davide Costanzo (University of Sheffield (GB)), Torre Wenaus (Brookhaven National Laboratory (US))
    • 09:10 09:30
      ATLAS S&C documentation overview 20m

      Doc project overview and status, what's the team's mandate, what is supported, what are the team activities, who is doing what, what is the current plan going forward

      Speaker: Maria Smizanska (Lancaster University (GB))
    • 09:30 09:50
      ATLAS S&C documentation tools 20m

      Closer selective look at tools in use like doxygen, jekyll, work underway/planned to integrate them and others; ie a more technical look at the current toolset and its evolution

      Speakers: Adam Edward Barton (Lancaster University (GB)), Alexey Boldyrev (Moscow State University (RU))
    • 09:50 10:05
    • 10:05 10:35
      Modern documentation tools and approaches 30m

      Experience, ideas, possible directions... from the speakers and their curation of the advance input

      Speakers: Giordon Holtsberg Stark (University of Chicago (US)), Mario Lassnig (CERN)
    • 10:50 11:15
      Survey of documentation tools and practices in other experiments 25m
      Speaker: Edward Moyse (University of Massachusetts (US))
    • 11:15 11:35
      Software education 20m
      Speaker: Stefan Kluth (Max-Planck-Institut fur Physik (DE))
    • 11:35 13:00
      Whiteboard discussion, conclusions, actions 1h 25m
      Speakers: Davide Costanzo (University of Sheffield (GB)), Torre Wenaus (Brookhaven National Laboratory (US))