Pledging EPR

• 2022: When pledging is available, use the iCMS epr tool... (https://icms.cern.ch/epr/)
  • Choose iCMS EPS, login CERN SSO if needed, select "New Pledge" in the upper right corner. Project/LV1 "Offline Software And Computing". Activity/L2: "Analysis Infrastructure and Support", LV3: "Documentation". Task: "Workbook". The L2 conveners, Katy or Stefano will accept your pledge and communicate with you about your efforts.
  • EPR due for an author: 4.0 months core tasks (including shifts).
  • Minimum pledge: 0.5 months, or as agreed with Katy.
  • After you pledge, Katy will contact you to organize which pages you will be editing so that different people are working on different sections.

Page editing assignments and editing rules

• These are updated assignments. 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)
    • Additionally, any example code that can be migrated from python2 to python3 should be modified
  • 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 Katy and Stefano (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 Katy 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.KatyEllis: 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/

Assignments table

Person	Page/page group	Notes	Status
Marguerite Tonjes	WorkBook	Want to put schools earlier on; remove WorkBook printout, review for pages that need updating
Jhovanny Andres Mejia Guisao	WorkBookRunningGrid	should just take a quick udpate and review, possibly trim it and make sure it points to crab tutorial and SWGuideCRAB which Stefano's team is keeping well up to date
Sudhir Malik		method/page to archive/depreciate PAT materials
Shengquan Tuo	WorkBookEDMTutorialProducer
Clayton Bennett
Itana Bubanja		review/change 4.3, 4.4, 4.5
Nitish Dhingra	WorkBookScramV1Intro	Ch 5.4, Appendix A.5 (scram) - link to SWGuide where appropriate

Unclaimed pages to edit table

Status:

%ICON{todo}% Not done 
%ICON{updated}%   In progress, some updated
%ICON{done}% Completed/Done

Completed 2022

Last year's edits

MargueriteTonjes - 2022-06-28