🗼 collection of software development tips and principles
“It is not enough for code to work.”
― Robert C. Martin
Ref: SOLID in wikipedia
Ref: Summary of 'Clean code' by Robert C. Martin
If you don't have your own guide, it's a good idea to adhere Google code style guides.
If you have your own guide, please keep it as general as possible.
Describe your changes in imperative mood, e.g. "make xyzzy do frotz" instead of "[This patch] makes xyzzy do frotz" or "[I] changed xyzzy to do frotz", as if you are giving orders to the codebase to change its behavior.
As is described at Documentation/SubmittingPatches in the Git repo
A specification for adding human and machine readable meaning to commit messages: https://www.conventionalcommits.org/en/v1.0.0/
TODOs should include the string TODO in all caps, followed by the name, or other identifier of the person who can best provide context about the problem referenced by the TODO, in parentheses.
Example:
// TODO(drew2a) Add todo convention to CONTRIBUTING.md
rebase + merge –no–ff
(more information)Example
feature/123
feature/657-add-travis-ci
fix/741
release/1.2
More information: Pull Request