qa-of-code-guidance icon indicating copy to clipboard operation
qa-of-code-guidance copied to clipboard

Issue on page /checklist_moderate.html. Explicit, rather than implicit names

Open JamesABaker opened this issue 2 years ago • 1 comments

We are having an issue interpreting the following line in the moderate checklist. We are seeking guidance on interpreting this.

- [ ] Names used in the code are explicit, rather than implicit.

How should we interpret this line? It feels like there are two interpretations.

  1. Firstly is that the variable names are precisely named like agriculture_data_parser rather than vaguely named parser or p.
    • I am not quite sure how this is different to - [ ] Names used in the code are informative and concise.
  2. Another interpretation is that we are talking about explicit and implicit variables or operands, but I don't see how the name would be part of this.

Any guidance would be greatly appreciated 😊

JamesABaker avatar Sep 15 '23 10:09 JamesABaker

I'm also looking for guidance on this 😊

emountier avatar Nov 08 '23 05:11 emountier