Enriched definition (#19014)

* Enriched definition

Added info about review results and common practices.

* Fixed grammar mistakes

Clarified the purpose of code reviews, re-written a sentence to improve it's clarity.
This commit is contained in:
Paul Isaris
2018-10-15 10:10:17 +03:00
committed by A-J Roos
parent 016a6f6c12
commit b70758322b

View File

@ -12,3 +12,10 @@ grow as a developer.
Is is important to be humble throughout the code review process. Accept your mistakes,
and be professional when pointing out improvements or errors in the code of your fellow
team members.
Code Reviews exist in order to improve the quality of the code in a software project.
A code review can be done amongst developers of the project under review, as well as developers from other teams in the same company.
Even if a review is just an explanation of the code to another programmer, the feeling that your code is going to be read/ inspected by another programmer as well makes you write better code in many ways (smaller methods, comments and no ["magic numbers"](https://en.wikipedia.org/wiki/Magic_number_(programming))).
As to what is reviewed and when, well there is no clear answer. Many teams have rules that every piece of code that checks-in in the version control system has to be reviewed by another programmer, while other teams have whole days when they dedicate to code reviews across the team.