code

Avoid double negative logic

Conditional logic should avoid double negatives.

Ensure documentation is easy to amend

When encountering documentation, it should be easy to make changes.

Documentation should be close to the code

Documentation, in all forms, should be as close as it can be to the code.

Open–closed principle

Software entities should be open for extension, but closed for modification.

Use searchable names

Use meaningful and pronounceable variable names

Use explanatory variables

Create variables to add meaning

Avoid Mental Mapping

Avoid using shorter replacement variables that aren't explicit

Use the same vocabulary for the same type of variable

Function arguments, ideally use 2 or fewer