Add examples to documentation for running with UT, and emulating HLT1,2 & sprucing without UT on expected24 MC

This MR adds two new pages to the documentation, which link to (with minimal description) examples showing how to:

• Emulate the whole trigger chain on expected-24 signal MC whilst we wait for central MC productions with trigger included,
• Run with the expected with-UT configuration

Docs can be found at https://rjhunter-docs.web.cern.ch/

TODO:

• Put docs somewhere
• Fix doc build again -> Rec!3837 (merged); independent of this MR
• Add tests? Probs not for speed- might need to follow-up.

added Documentation label

assigned to @rjhunter

added RTA label

changed the description

added 18 commits

• 94f25f87...c56c24f7 - 4 commits from branch master
• c56c24f7...8dedfcec - 4 earlier commits
• dd5b6203 - Add new section for HLT1->Sprucing chain with expected24 sample
• e62c9db0 - Update to Andre settings
• 08890d66 - Update sprucepass example after testing
• a0184c5d - Fix typo; make more clear what sprucepass example should be used for
• 211a66b0 - Trim down the with-UT example and make it usable
• eae0372c - Add in example to run with UT
• e944a808 - Better title
• 6fee157c - fix booboo - use right reco config
• 5b456819 - Fix formatting
• 642ed60e - Please linting check

Compare with previous version

marked the checklist item Put docs somewhere as completed

added 20 commits

• 642ed60e...db8877e2 - 6 commits from branch master
• db8877e2...109356d7 - 4 earlier commits
• e2e46594 - Add new section for HLT1->Sprucing chain with expected24 sample
• 2ebbfeed - Update to Andre settings
• 2a53ac83 - Update sprucepass example after testing
• f0c6a563 - Fix typo; make more clear what sprucepass example should be used for
• c496f983 - Trim down the with-UT example and make it usable
• 12010836 - Add in example to run with UT
• a7313492 - Better title
• fef1c5e7 - fix booboo - use right reco config
• 67a09eb0 - Fix formatting
• 44aad10f - Please linting check

Compare with previous version

Hey @rjhunter, these look great to me, again thanks for doing this!

I have a few minor comments/questions

Somewhat Nitpicky question:

Would it be more appropriate for the sprucing options to live under Hlt2Conf/options/sprucing/ instead of Hlt2Conf/options/?

There's some non-uniformity between the withUT and withoutUT configurations and visually I don't think a lot of them are necessary.

I think it's cleaner/clearer for newcomers if the diff between the two is really just what is necessary (and like, file names ).

added 4 commits

• 23b21aff - Luke suggestion on being more explicit with turbo and full naming
• 5c651213 - Fix doc string
• 32467a45 - Add warning that grid proxy will be needed for file provided
• 8b156dd2 - More instructions on running the snippets

Compare with previous version

added 1 commit

• a6e938a7 - Move spruce snippets to under sprucing/

Compare with previous version

resolved all threads

approved this merge request

added 1 commit

• 6e9bbe88 - withUT example: align doc string with other examples, remove DD4HEP support as it still dont work

Compare with previous version