CMS Experiment https://twiki.cern.ch/twiki/bin/view/CMSPublic/WorkBook

Pledging EPR

• Spring, 2020: pledging now available in the iCMS epr tool... (https://icms-epr.cern.ch/)
  • Choose iCMS EPS, login CERN SSO if needed, in "Offline & Computing", choose "Tasks", and search for "Documentation", click on the green "+" in the second from the right column to pledge. Put in your number of months in the "Work Pledge" - choosing "WorkBook" or "Software Guide" as appropriate.
  • EPR due for an author: 4.0 months core tasks (including shifts)

Page editing assignments and editing rules

• These are updated assignments as of June 16, 2020. We have many more pages to review and update after this. If you get done quickly, let me know. If you find mistakes elsewhere in the WorkBook while investigating, or have a preferred assignment that isn't listed below, let us know and you can most likely update that page as well.
• Overall guidelines: Review the material, make sure commands still work, and the methods make sense.
  • Wherever possible, bring up to date to CMSSW for RunII analyses, using slc7 (cc7)
  • Move analysis examples to NanoAOD whenever possible
  • For data/analysis archival purposes, never delete WorkBook pages, if necessary make new ones instead and make it clear at the bottom the reference to the old page that is repaged
  • We have an EOS area to write small tutorial files to, contact Marguerite and Sudhir (L2 conveners for Analysis Infrastructure & Support) for access.
  • Feel free to consult PAG/POG experts, ask in their hypernews, check HATS, CMSDASand other tutorials for recent recipes. Let Marguerite and Sudhir know if you have questions.
  • Never delete twiki pages completely, we must retain them for data preservation
• Chapter numbers are for r348 of the WorkBook
• To see if there have been recent changes by other people to your page:
  • All CmMSPublic twiki pages recently changed (search for "WorkBook" to find yours): CMSPublic/WebChanges
  • You could sign up for the WebNotify service to be emailed automatically about changes, that page has some information, but otherwise, you just add your name to the top, for instance, I added:

       * Main.MargueriteTonjes: WorkBook*

  • Note I was unable to get the RSS feed service to work, and the "Watch" plugin is not installed
• Also interesting is the WebStatistics twiki, which tells you what pages in the CMSPublic twiki were most frequently accessed. We may wish to use that to monitor what pages of the WorkBook are accessed the most. Note that as we improve the directions, some pages may get accessed more frequently than before.
• Editing overview page for some overall editing rules: https://twiki.cern.ch/twiki/bin/view/CMSPublic/WorkBookUsage and https://twiki.cern.ch/twiki/bin/view/CMSPublic/WorkBookContributors
• Interesting perspective on documentation: https://www.divio.com/blog/documentation/

Last year's edits

-- MargueriteTonjes - 2020-05-28