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

Pledging EPR

  • Spring, 2021: When pledging is available, use the iCMS epr tool... (https://icms.cern.ch/epr/)
    • Choose iCMS EPS, login CERN SSO if needed, use menu "Tasks", choose "Tasks for Project Offline Software And Computing", then search for "Documentation", choose "WorkBook", click on the green "+" in the second from the right column to pledge. Put in your number of months in the "Work Pledge", and click "Submit". The L2 conveners, Marguerite or Sudhir will accept your pledge and communicate with you about your efforts.
    • EPR due for an author: 4.0 months core tasks (including shifts)
    • After you pledge, Marguerite and/or Sudhir 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 as of February 16, 2021. 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 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/

Assignments table

* needs edit!*
Person Page/page group Notes StatusSorted ascending
Shengquan Tuo WorkBookWriteFrameworkModule update to be new student-friendly and 2021 accurate DONE
Nitish Dhingra WorkBookBasicROOT Ch 5.4, Appendix A.4 (ROOT basics) DONE
Nitish Dhingra WorkBookBasicCPlusPlus Ch 5.4, Appendix A.7 (Basic C++ in CMSSW context) DONE
Itana Bubanja   review/change 4.3, 4.4, 4.5  
Marguerite Tonjes WorkBook Want to put schools earlier on; remove WorkBook printout, review for pages that need updating, depreciate/retire PAT TODO
Jhovanny Andres Mejia Guisao WorkBookFWLitePython update for python3 as appropriate, also consider adding in pyROOT and other newer analysis tools TODO
Sudhir Malik   method/page to archive/depreciate PAT materials TODO
Shengquan Tuo WorkBookEDMTutorialProducer   TODO
Clayton Bennett WorkBookBTagging review/rewrite 7.9 WorkBookBTagging TODO
Itana Bubanja WorkBookGenIntro review 6.1 WorkBookGenIntro TODO
Itana Bubanja WorkBookGeneration review 6.2 WorkBookGeneration TODO
Itana Bubanja WorkBookSimDigi review 6.3 WorkBookSimDigi TODO
Itana Bubanja WorkBookReco review 6.4 WorkBookReco TODO
Nitish Dhingra WorkBookScramV1Intro Ch 5.4, Appendix A.5 (scram) - link to SWGuide where appropriate TODO

Unclaimed pages to edit table

Below is not yet assigned     You can claim them when you finish above, please move the line above and put your name there!
Person Page/page group Notes Status
  WorkBookFileTransfer needs remove PhEDEx and update to rucio, also document automated crab transfer method  
  WorkBookMonitoringTutorial pick up latest CRAB links and rewrite completely, also show how to monitor site status  
  WorkBookCMSConnect this should basically just link to the CMS Connect site which is being kept up to date and docs with easy list: 1) how to get account 2) self-guided tutorials 3) recorded tutorials (LPC HATS)  
  SWGuideCrabAtCAF LSF doesn't exist anymore, is this even possible or need to be depreciated/retired?  
  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  
  WorkBookDQM review and see if it needs updated  
  WorkBookGridComputingContext review and update (is this page needed or can be simplified?)  
       
       

Status:

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

Completed 2021

Person Page/page group Notes Status - finished
       
       
       

Last year's edits

Last years edits: WorkBookEditorsAssignments2020

MargueriteTonjes - 2021-07-16

Edit | Attach | Watch | Print version | History: r15 | r13 < r12 < r11 < r10 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r11 - 2022-01-26 - MargueriteTonjes
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    Main All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback