How do I turn a vague criterion into a checkable one?
- Vague criteria look like this: "the code should be good", "the docs should be complete". They cannot be checked, only argued about.
- 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".
- 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).
- 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