---
{
  "n": 27,
  "title": "Name a declaration with the word a reader already knows",
  "abstract": "",
  "refs": [],
  "seen": [
    "agent",
    "user"
  ],
  "data": {
    "keywords": [
      "classvar",
      "attribute",
      "variable",
      "rename",
      "naming",
      "name it",
      "call it",
      "field"
    ]
  },
  "created": 1789946077.4023292,
  "updated": 1789953831.0834591,
  "deleted": 0.0,
  "completed": 0.0,
  "outcome": "",
  "type": "rule"
}
---
An attribute, a variable or a field gets the ordinary programming word for what it holds, not an evocative one. was, heard and alone were poetry; aliases, notify_actions and urgent_actions are what they are. The test: could a reader who has never seen this codebase guess what it holds from the name alone? Prose belongs in the help text and the abstract, where it is read as prose. This does not license abbreviations — a plain word in full, not a short one.