CMS running documentation to-do list for 2023-2024.

[jmhogan]

CMS will do a big documentation update in Autumn '23 -- Winter '24. This encompasses pages on the Portal, the Open Data Guide, and public CMS TWikis

Open Data Portal pages

• [x] Guide to research use: update format (mostly "exploring" sections) from years --> file types, adding 2015 MiniAOD.
• [ ] Guide to trigger system: update with clear methods of accessing trigger info in AOD, MiniAOD.
• [ ] Guide for event production: broaden to include examples for MiniAOD production
• [x] Docker Guide needs container info for ROOT and Python
• [x] Getting Started pages:
  • [x] Morph 2010, 2011-2012, and 2015 pages into a "Getting Started with CMS (AOD Data 2010-2012)(MiniAOD Data 2015-on)" (and adapt to future file types). Pages should include:
    • Docker container instructions for each year on the page, hopefully in tabs
    • Data contents and how to list them (differs by file type). Link to Open Data Guide
    • EDAnalyzer example (differs by file type)
    • POET example for filtering and analyzing (for AOD and MiniAOD pages, using relevant branches)
    • Links and references.
  • [x] Test POET 2011 branch with 2010 container and file to look for issues using this analyzer.
  • [x] Get tab support or find another solution #3451

Pages needing only link checks and small updates with any future releases:

• [x] https://opendata.cern.ch/docs/cms-guide-docker
• [x] https://opendata.cern.ch/docs/about-cms
• [x] https://opendata.cern.ch/docs/cms-guide-pileup-simulation

New tools pages to creat:

• [x] NanoAODRun1Examples: https://github.com/cms-opendata-analyses/NanoAODRun1Examples
• [x] NanoAOD-tools: https://github.com/cms-nanoaod/nanoAOD-tools/

Duplicate records of documentation pages to remove after checking for any links that point to them:

• [ ] https://opendata.cern.ch/record/70 --> https://opendata.cern.ch/docs/cms-guide-pileup-simulation
• [ ] https://opendata.cern.ch/record/71 --> https://opendata.cern.ch/docs/cms-simulated-dataset-names
• [x] https://opendata.cern.ch/docs/cms-guide-troubleshooting --> Make this point to the CMS Open Data Guide FAQ for easier maintenance.

CMS Open Data Guide pages

• [ ] https://github.com/cernopendata/cms-opendata-guide/issues/113

[katilp]

With NanoAOD being available, we could update the portal docker guide https://opendata.cern.ch/docs/cms-guide-docker to include instructions for the root/python container usage.

It could have separate sections similar to Available CMSSW container images Fetch a CMSSW image and start a container