From 8745ace276de0dd873243adecb6f885d4d2edd48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Charly=20Chac=C3=B3n?=
 <107764250+Charlytoc@users.noreply.github.com>
Date: Tue, 30 Apr 2024 15:38:06 -0500
Subject: [PATCH] Create how-to-review-code.md

---
 how-to-review-code.md | 58 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 how-to-review-code.md

diff --git a/how-to-review-code.md b/how-to-review-code.md
new file mode 100644
index 000000000..c37d82301
--- /dev/null
+++ b/how-to-review-code.md
@@ -0,0 +1,58 @@
+# Guide to Effective Code Reviews
+
+Code Reviews are one of the most interesting features of 4Geeks.com. They provide mentors with a quick tool to review code, and students with additional feedback to improve as developers. A Code Review, as the name suggests, is simply a comment regarding a portion of code. In this article, we will analyze the desirable characteristics that a Code Review should have to be effective for the student.
+
+Let's start with the basics:
+
+# How to perform a Code Review on the 4Geeks.com platform?
+### Step 1: **Select a program.**
+If you are a mentor, you have a dashboard where you can see the different programs or cohorts you are in. The first step to perform a Code Review is to enter one of these programs.
+
+![example programs](https://github.com/breatheco-de/breatheco-de/assets/107764250/ed6cfb70-bd4a-4571-b632-7d1d82bd76a4)
+
+### Step 2: Go to the **Assignments** section
+You need to perform Code Reviews on a student's submission, so head to that section.
+![assignments](https://github.com/breatheco-de/breatheco-de/assets/107764250/8e818c70-d71f-4e1b-ba1c-b20359468234)
+
+### Step 3: **Select the projects view**
+
+![Select projects view](https://github.com/breatheco-de/breatheco-de/assets/107764250/a5604dd2-4d69-4d44-b80f-76eda5c61020)
+
+### Step 4: **Select a project**
+The projects available for Code Review are those that have been submitted, these will appear with a blue button and the text "Review" on it. Press that button.
+
+![review button](https://github.com/breatheco-de/breatheco-de/assets/107764250/2da5d7e5-6953-48ec-95a3-bb18da4ad4f0)
+
+### Step 5: **Start doing Code Reviews**
+If the project does not have at least 3 Code Reviews, it cannot be marked as **Approved** or **Rejected**. Press the "Start code review" button to begin reviewing.
+
+![Start code review](https://github.com/breatheco-de/breatheco-de/assets/107764250/08e37594-b12f-4e3d-a56c-1b3383fdc187)
+
+### Step 6: **Select the Commitfile you want to review**
+A commitfile is a file modified by a student in a particular commit. By default, Rigobot analyzes the last three commits of a repository, and depending on the **Committer** of interest, extracts the necessary files in each commit. Commitfiles are a fundamental part of the Code Review, it's good to know the use of that file in the project you are reviewing so that the review makes more sense.
+
+What does each item in the Commitfiles modal mean?
+**File**: It is the file modified by a student in a commit.
+**Feedback status**: It gives us information about whether the student has already reviewed and rated the Code Review or not.
+**Reviews**: The number of Code Reviews that each file has.
+
+Select a Commitfile with the button: **Start Review**.
+
+![commitfiles view](https://github.com/breatheco-de/breatheco-de/assets/107764250/e82e7315-2673-4a68-ae85-5eafd909945e)
+
+### Step 7: **Select a portion of code from the Commitfile**
+When you select a Commitfile, a modal will display with the code of that particular file, you can select the lines you want to comment on, then press the blue button to start the Code Review.
+
+> Suggestion: Review all the code first, so you can know exactly where the code has flaws or possible improvements before going and selecting any part that seems improvable, the files usually have a sense and this sense is important for giving quality reviews.
+
+![Select code from commitfile](https://github.com/breatheco-de/breatheco-de/assets/107764250/6e8f7dd7-08de-4d26-b39d-2b3b492a7f1f)
+
+![Selected code](https://github.com/breatheco-de/breatheco-de/assets/107764250/f2565833-b79a-4a2e-ae32-8f29d1c2b326)
+
+### Step 8: **Write the comment.**
+Commenting on the Code Review is perhaps the most important part. Later you will find a guide to points to consider when writing a quality Code Review. After writing a quality comment, press the **Submit** button and you will have completed your first Code Review.
+
+![Write a comment](https://github.com/breatheco-de/breatheco-de/assets/107764250/53c88ae8-2a22-496b-a13e-65f3bdb2102a)
+
+
+