The more change descriptions focus on the purpose and intent (the "why") of the code, the more helpful they are during both review and future code archaeology.
Code comments are a great place for the nitty-gritty (the "how").
The more change descriptions focus on the purpose and intent (the "why") of the code, the more helpful they are during both review and future code archaeology.
Code comments are a great place for the nitty-gritty (the "how").