Avoid using shorter replacement variables that aren't explicit
Create variables to add meaning
Software entities should be open for extension, but closed for modification.
Documentation, in all forms, should be as close as it can be to the code.
When encountering documentation, it should be easy to make changes.
Conditional logic should avoid double negatives.