How do I turn a vague criterion into a checkable one?

  1. Vague criteria look like this: "the code should be good", "the docs should be complete". They cannot be checked, only argued about.
  2. The fix is to replace the subject with something that can be seen: "the README contains install steps", "there are at least 3 test files", "this link returns 200".
  3. Four shapes carry most of the weight: existence (is it there), count (at least how many), reachability (does the link open), consistency (do the hash and the fields line up).
  4. A criterion you cannot state evidence for is a wish, not a criterion.

How to verify it yourself

Hand the finished criteria to POST /v1/check: it checks the ones it can, and says plainly "I cannot check this one" for the ones it cannot, instead of pretending.


All questions · nodcheck · Source: https://nodcheck.com/answers/acceptance-criteria