toebes / ciphers

Cipher Generators
BSD 3-Clause "New" or "Revised" License
13 stars 4 forks source link

Consider showing the test difficulty on the Test Generator #532

Open toebes opened 2 months ago

toebes commented 2 months ago

Provide an indication of how hard/soft a test might be. Value should be stored with the test and recalculated whenever something on the test changes.

Things to take into consideration:

  1. Not specifying where a fractionated morse crib is
  2. Not specifying where a Baconian Words Crib is
  3. Patristocrats without a crib
  4. Questions which are all too hard (high score values based on suggested scores)
  5. Too few of variety of ciphers
  6. Lack of "gimme" ciphers to ensure nobody scores a 0
  7. Tests leaving all offsets at the default
  8. Missing keywords on keyword ciphers (or super short keywords)
toebes commented 2 weeks ago

Also move the error up above the test.

Agilus commented 2 weeks ago

I've revised the end of the one-pager I shared with you in May for Division C and added the following Test Difficulty Checklist that contains the issues that we've identified in this area. It's more of a guidance document intended to help writers avoid potholes than a "here are the rules" document - test writers experienced with the ciphers can definitely deviate from these. Once we get it where we want it, hopefully we can get the national folks to put it under the "Event Supervisor" subsection of the Codebusters resources.

Otherwise, though, I don't really have any suggestions on how to quantify this. I like Randy's suggestion of having a "Review my test" button that could check for potholes like these, but am mindful of your point that people may not even get as far as to click on it if they are really unfamiliar with our tools. I do think some of them we can work into error messages: ciphers where K1/2/3 was clicked on but no keyword was entered; Xenocrypts and Patristocrats not encoded as K1/2s; and tests that are too short seem like the lowest-hanging fruits here.

Test Difficulty Checklist The following is intended to be a helpful review to help avoid common issues that result in tests being too easy or too hard.