qa-of-code-guidance
qa-of-code-guidance copied to clipboard
Issue on page /checklist_moderate.html. Explicit, rather than implicit names
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.
- Firstly is that the variable names are precisely named like
agriculture_data_parserrather than vaguely namedparserorp.- I am not quite sure how this is different to
- [ ] Names used in the code are informative and concise.
- I am not quite sure how this is different to
- 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 😊
I'm also looking for guidance on this 😊