FCC Documentation and Training - October 2, 2026

Present: Benedikt Wach, David Lange, Alexander Moreno, Michel Villanueva

Introduction

• Done since the last meeting
  • CONTRIBUTING, LICENSE and Code of conduct now on top of the repository, and shown by GitHub
• Reviews in progress
  • Update documentation to reflect script availability of dd4hep2root (#207)
    • We will wait for the new key4hep release
  • Update Delphes+EvtGen sample generation to latest Key4Hep (#206)
    • Just waiting for green light from Brieuc (probably OK just to merge it)
  • Intro to distributed computing (#200)
    • Michel will find some time to update this
• Pending action items
  • Add an introduction for FCCAnalyses - #203
    • Benedikt working on it, based on the improvements at the BNL/CERN school
  • Add “How to get help” information - #205
  • Windows section: update to use WSL - #189
    • Benedikt updating it, testing in his Windows laptop
  • Review instructions on how to access LXPlus, add a link to the CERN docs - #187
    • Contact maintainers!
    • Let’s test access to the BNL AF - https://jupyter-fedid.sdcc.bnl.gov/

Switching to Jupyter Book v2 from Sphinx

• So far we have discussed on the themes of Sphinx for the tutorials
• However, Jupyter Book v2 natively supports Markdown
  • Less work on our side about dependencies
• Open a PR and request feedback on the mailing list
  • First mailing list and Mattermost, then we wait for the next meeting
  • After that, add a note in the newsletter requesting more feedback

FCC week

• Let’s brainstorm on what would be useful for a 90 min session and we discuss
  • Documentation hackathon?
  • We can prototype a doc hackathon in advance (via Zoom), to gain experience and polish details towards a hackathon in person