Browse Source

Created doc for Reviews.

pull/301/head
Marie Malarme 5 years ago committed by Clément
parent
commit
46a251c9c1
  1. BIN
      docs/img/reviews/Screenshot 2019-10-17 at 01.59.32.png
  2. BIN
      docs/img/reviews/Screenshot 2019-10-17 at 02.03.11.png
  3. BIN
      docs/img/reviews/Screenshot 2019-10-17 at 02.05.46.png
  4. BIN
      docs/img/reviews/Screenshot 2019-10-17 at 02.20.18.png
  5. BIN
      docs/img/reviews/Screenshot 2019-10-17 at 02.22.30.png
  6. BIN
      docs/img/reviews/Screenshot 2019-10-17 at 02.24.04.png
  7. BIN
      docs/img/reviews/Screenshot 2019-10-17 at 02.38.37.png
  8. 48
      docs/reviews.md

BIN
docs/img/reviews/Screenshot 2019-10-17 at 01.59.32.png

diff.bin_not_shown

After

Width:  |  Height:  |  Size: 638 KiB

BIN
docs/img/reviews/Screenshot 2019-10-17 at 02.03.11.png

diff.bin_not_shown

After

Width:  |  Height:  |  Size: 1.4 MiB

BIN
docs/img/reviews/Screenshot 2019-10-17 at 02.05.46.png

diff.bin_not_shown

After

Width:  |  Height:  |  Size: 707 KiB

BIN
docs/img/reviews/Screenshot 2019-10-17 at 02.20.18.png

diff.bin_not_shown

After

Width:  |  Height:  |  Size: 707 KiB

BIN
docs/img/reviews/Screenshot 2019-10-17 at 02.22.30.png

diff.bin_not_shown

After

Width:  |  Height:  |  Size: 725 KiB

BIN
docs/img/reviews/Screenshot 2019-10-17 at 02.24.04.png

diff.bin_not_shown

After

Width:  |  Height:  |  Size: 734 KiB

BIN
docs/img/reviews/Screenshot 2019-10-17 at 02.38.37.png

diff.bin_not_shown

After

Width:  |  Height:  |  Size: 639 KiB

48
docs/reviews.md

@ -0,0 +1,48 @@
# Reviews
## Context
Only bonus exercises can be reviewed, which are the last items of a quest.
Bonus exercises are available in quests 02 / 03 / 04 / 05 /07 / 08 / 09.
<img width="1073" alt="Screenshot 2019-10-17 at 02.38.37" src="img/reviews/Screenshot 2019-10-17 at 02.38.37.png">
Making a review involves 2 students who are gonna review each other's exercise.
Each user has to :
- check the code of the other one on Github
- bet if it's gonna fail or succeed in the Review interface
- run his own exercise in the Review interface to give a result to compare with the bet, and state if it was right or wrong
## Usage
To submit an exercise to review and be reviewed, go to the `Review panel` on the right of the quest interface and click on the button to submit it :
<img width="1073" alt="Screenshot 2019-10-17 at 01.59.32" src="img/reviews/Screenshot 2019-10-17 at 01.59.32.png">
Then, when a match with another student who also wants to review is found, you'll be notified :
<img width="1073" alt="Screenshot 2019-10-17 at 02.03.11" src="img/reviews/Screenshot 2019-10-17 at 02.03.11.png">
Once you and the other student have confirmed the match, you can go and check the code of the other student on his repository in the component `Your review` :
<img width="1073" alt="Screenshot 2019-10-17 at 02.05.46" src="img/reviews/Screenshot 2019-10-17 at 02.05.46.png">
When you've checked his code, those 4 steps will have to be completed to achieve the review :
- You have to bet if the exercise of the other student will fail or succeed after running the tester
- The other student has to do the same with your exercise and make his own bet, that you can see on the component `Review of your exercise`
<img width="1073" alt="Screenshot 2019-10-17 at 02.20.18" src="img/reviews/Screenshot 2019-10-17 at 02.20.18.png">
- Once the other student's bet is set, the tester button unblocks and you have to run it on your exercise to output the result determining if your exercise has failed or succeeded ; this result is compared to the other student's bet to determine if it was wrong or right
- The other student also has to run the tester on his exercise to determine his result and so if your bet was wrong or right
<img width="1073" alt="Screenshot 2019-10-17 at 02.22.30" src="img/reviews/Screenshot 2019-10-17 at 02.22.30.png">
In fact, a bet is succeeded if it's equal as the tester output :
<img width="1073" alt="Screenshot 2019-10-17 at 02.24.04" src="img/reviews/Screenshot 2019-10-17 at 02.24.04.png">
You can have those 4 cases :
- You bet that the exercise will **fail**, the tester output states that the exercise has **failed** -> the bet is **succeeded**
- You bet that the exercise will **succeed**, the tester output states that the exercise has **succeeded** -> the bet is **succeeded**
- You bet that the exercise will **fail**, the tester output states that the exercise has **succeeded** -> the bet is **failed**
- You bet that the exercise will **succeed**, the tester output states that the exercise has **failed** -> the bet is **failed**
Loading…
Cancel
Save