Browse Source

typo review

content-update
Chris 3 years ago committed by Christopher Fremond
parent
commit
e68a4f2740
  1. 12
      subjects/guess-it-1/README.md
  2. 10
      subjects/guess-it-1/audit/README.md
  3. 16
      subjects/guess-it-2/README.md
  4. 14
      subjects/guess-it-2/audit/README.md
  5. 10
      subjects/linear-stats/README.md
  6. 2
      subjects/linear-stats/audit/README.md
  7. 4
      subjects/make-it-better/README.md
  8. 10
      subjects/math-skills/README.md
  9. 4
      subjects/math-skills/audit/README.md

12
subjects/guess-it-1/README.md

@ -43,15 +43,15 @@ This range should have a space separating the lower limit from the upper one lik
...
```
As you can see, some of the ranges are not correct and some are bigger than others. But this is just an example, if you want you can give a specific range in your program, that is fully up to you to decide. The intent of this exercise is for you to use the calculations you did in the `math-skills` exercise to guess the numbers.
As seen above, some of the ranges are not correct and some are bigger than others. As this is just an example, if you so wish, a specific range in your program can be given. That is fully up to you to decide. The intent of this exercise is to use the calculations you did in the `math-skills` exercise to guess the numbers.
### Testing
Your program will be extensively tested, so performance should be prioritized. Talking about testing, here is how it will work.
Your program will be extensively tested, so performance should be prioritized. Testing will work as follow:
If you guess correctly the range for the next given number, your score will be incremented based on the size of your range. In other words, the bigger your range is, the smaller your score will be. So my advice is for you to find the perfect balance between a small range and a good guess.
If you guess correctly the range for the next given number, your score will be incremented based on the size of your range. In other words, the bigger your range is, the smaller your score will be. So we advise you to find the perfect balance between a small range and a good guess.
So that auditors can test your program, you will have to follow the next steps:
In order for auditors to test your program, you will have to follow the next steps:
- create a folder called **`student`**
- copy the files that are needed to run your program into this folder
@ -68,9 +68,9 @@ node ./student/solution.js
You can choose in which language you want to build your program.
If you fail one of this steps, the test will not work. So we advise you to run the test by downloading [this zip file](https://assets.01-edu.org/guess-the-number.zip) containing the tester. You should place the `student/` folder in the root directory of the items provided and read its instructions. The data sets used to test this exercise will be `Data 1`, `Data 2` and `Data 3`.
If you fail one of these steps, the test will not work. So we advise you to run the test by downloading [this zip file](https://assets.01-edu.org/guess-the-number.zip) containing the tester. You should place the `student/` folder in the root directory of the items provided and read its instructions. The data sets used to test this exercise will be `Data 1`, `Data 2` and `Data 3`.
This project will help you learn about:
- Statistical and Probabilities Calculations
- Statistical and Probabilities Calculation
- Scripting

10
subjects/guess-it-1/audit/README.md

@ -2,20 +2,22 @@
##### After downloading [this zip file](https://assets.01-edu.org/guess-the-number.zip) containing a tester, follow its instructions (present in the README) in order to test the student program against the `big-range` program 3 times using the `Data 1`.
###### Did the student won against `big-range` most of the times?
###### Did the student won against `big-range` most of the times (at least 2 out of 3 times)?
##### Try running the student program against the `big-range` program, using `Data 2` and then `Data 3` 3 times each.
###### Did the student won against `big-range` most of the times (at least 2 out of 3 times for each)?
##### Try running the student program against the `average` program, using `Data 1`, `Data 2` and `Data 3` 3 times each.
###### Did the student won against `average` most of the times?
###### Did the student won against `average` most of the times (at least 2 out of 3 times for each)?
##### Try running the student program against the `median` program, using `Data 1`, `Data 2` and `Data 3` 3 times each.
###### Did the student won against `median` most of the times?
###### Did the student won against `median` most of the times (at least 2 out of 3 times for each)?
#### Bonus
##### Try running the student program against the `nic` program, using `Data 1`, `Data 2` and `Data 3` 3 times each.
###### +Did the student won against `nic` most of the times?
###### +Did the student won against `nic` most of the times (at least 2 out of 3 times for each)?

16
subjects/guess-it-2/README.md

@ -2,13 +2,13 @@
### Objectives
Now that you have even more statistical knowledge, you will guess even more numbers. This time will be a bit harder.
Now that you have even more statistical knowledge, you will guess even more numbers. This time it will be a bit harder.
### Instructions
That is right, you must build a program that given a number as standard input, prints out a range in which the next number provided should be, just like last time.
That is right, you must build a program that given a number as standard input, prints out a range in which the next number provided should be. Just like last time.
The data received by the program, as always, will be presented as the following example:
The data received by the program, as always, will be presented as below:
```console
189
@ -43,15 +43,15 @@ This range should have a space separating the lower limit from the upper one lik
...
```
As you can see, some of the ranges are not correct and some are bigger than others. But this is just an example, if you want you can give a specific range in your program, that is fully up to you to decide. The intent of this exercise is for you to use the calculations you did in the previous exercise (`linear_stats`) to guess the numbers.
As you can see, some of the ranges are not correct and some are bigger than others. This is just an example. If you wish, you can give a specific range in your program, that is fully up to you to decide. The intent of this exercise is for you to use the calculations you did in the previous exercise (`linear_stats`) to guess the numbers.
### Testing
Your program will be extensively tested, so performance should be prioritized. Talking about testing, here is how it will work.
Your program will be extensively tested, so performance should be prioritized. Testing will work as follow:
If you guess correctly the range for the next given number, your score will be incremented based on the size of your range. In other words, the bigger your range is, the smaller your score will be. So my advice is for you to find the perfect balance between a small range and a good guess.
If you correctly guess the range for the next given number, your score will be incremented based on the size of your range. In other words, the bigger your range is, the smaller your score will be. So we advise you to find the perfect balance between a small range and a good guess.
So that auditors can test your program, you will have to follow the next steps:
In order for auditors to test your program, you will have to follow the next steps:
- create a folder called **`student`**
- copy the files that are needed to run your program into this folder
@ -68,7 +68,7 @@ node ./student/solution.js
You can choose in which language you want to build your program.
If you fail one of this steps, the test will not work. So we advise you to run the test by downloading [this zip file](https://assets.01-edu.org/guess-the-number.zip) containing the tester. You should place the `student/` folder in the root directory of the items provided and read its instructions. The data sets used to test this exercise will be `Data 5` and `Data 6`.
If you fail one of these steps, the test will not work. So we advise you to run the test by downloading [this zip file](https://assets.01-edu.org/guess-the-number.zip) containing the tester. You should place the `student/` folder in the root directory of the items provided and read its instructions. The data sets used to test this exercise will be `Data 5` and `Data 6`.
This project will help you learn about:

14
subjects/guess-it-2/audit/README.md

@ -2,24 +2,26 @@
##### After downloading [this zip file](https://assets.01-edu.org/guess-the-number.zip) containing a tester, follow its instructions (present in the README) in order to test the student program against the `big-range` program 3 times using the `Data 4`.
###### Did the student won against `big-range` most of the times?
###### Did the student won against `big-range` most of the times (at least 2 out of 3 times)?
##### Try running the student program against the `big-range` program, using `Data 5` 3 times each.
##### Try running the student program against the `big-range` program, using `Data 5` 3 times.
###### Did the student won against `big-range` most of the times (at least 2 out of 3 times for each)?
##### Try running the student program against the `linear-regr` program, using `Data 4` and `Data 5` 3 times each.
###### Did the student won against `linear-regr` most of the times?
###### Did the student won against `linear-regr` most of the times (at least 2 out of 3 times for each)?
##### Try running the student program against the `correlation-coef` program, using `Data 4` and `Data 5` 3 times each.
###### Did the student won against `correlation-coef` most of the times?
###### Did the student won against `correlation-coef` most of the times (at least 2 out of 3 times for each)?
#### Bonus
##### +Try running the student program against the `mse` program, using `Data 4` and `Data 5` 3 times each.
###### +Did the student won against `mse` most of the times?
###### +Did the student won against `mse` most of the times (at least 2 out of 3 times for each)?
##### +Try running the student program against the `nic` program, using `Data 4` and `Data 5` 3 times each.
###### +Did the student won against `nic` most of the times?
###### +Did the student won against `nic` most of the times (at least 2 out of 3 times for each)?

10
subjects/linear-stats/README.md

@ -1,10 +1,10 @@
## linear-stats
This time, like in the first exercise, you will have to build a program that prints various statistical calculations. Now you will focus on the `Linear Regression Line` and the `Pearson Correlation Coefficent`.
This time, like in the first exercise, you will have to build a program that prints various statistical calculations. Now, you will focus on the `Linear Regression Line` and the `Pearson Correlation Coefficent`.
### Instructions
Your program must be able to read from a file and print the result of each statistic mentioned above. In other words your program must be able to read the data present in the path passed as argument. The data in the file will be presented as the following example:
Your program must be able to read from a file and print the result of each statistic mentioned above. In other words, your program must be able to read the data present in the path passed as argument. The data in the file will be presented as below:
```console
189
@ -18,7 +18,7 @@ Your program must be able to read from a file and print the result of each stati
This data represents a graph in which the values of the x axis are the number of the lines (0, 1, 2, 3, 4, 5 ...) and the values of the y axis are the actual numbers (189, 113, 121, 114, 145, 110...).
To run your program will be used a command similar to this one if your project is made in Go:
To run your program, a command similar to this one will be used if your project is made in Go:
```sh
>$ go run your-program.go data.txt
@ -35,9 +35,9 @@ The values in between the single angle quotation marks (`< >`) should be a decim
#### Testing
Your program will be tested by an auditer who will run a program provided by us, that creates a random data set of numbers and prints the result. The auditer job is to compare how your program performed.
Your program will be tested by an auditor who will run a program provided by us, that creates a random data set of numbers and prints the result. The auditor task is to compare how your program performed.
You can choose in which language you want to build your program.
You can choose the language in which you want to build your program.
This program will help you learn about:

2
subjects/linear-stats/audit/README.md

@ -16,4 +16,4 @@
#### Bonus
###### +Did the student provided a README with explanation on how to test his/her program?
###### +Did the student provided a README with an explanation on how to test his/her program?

4
subjects/make-it-better/README.md

@ -2,7 +2,7 @@
### Instructions
Create the files and directories so that when you use the command `ls` below the output will look like this :
Create the files and directories so that when you use the command `ls` below, the output will look like this :
```console
$ TZ=utc ls -l --time-style='+%F %R' | sed 1d | awk '{print $1, $6, $7, $8, $9, $10}'
@ -20,7 +20,7 @@ dr-------x 1995-04-10 10:10 A
$
```
Once it's done, use the command below to create the file `done.tar` to be submitted.
Once it is done, use the command below to create the file `done.tar` to be submitted.
```console
$ tar -cf done.tar *

10
subjects/math-skills/README.md

@ -11,7 +11,7 @@ The purpose of this project is for you to calculate the following:
### Instructions
Your program must be able to read from a file and print the result of each statistic mentioned above. In other words your program must be able to read the data present in the path passed as argument. The data in the file will be presented as the following example:
Your program must be able to read from a file and print the result of each statistic mentioned above. In other words, your program must be able to read the data present in the path passed as argument. The data in the file will be presented as the following example:
```console
189
@ -25,7 +25,7 @@ Your program must be able to read from a file and print the result of each stati
This data represents a graph in which the values of the x axis are the number of the lines (0, 1, 2, 3, 4, 5 ...) and the values of the y axis are the actual numbers (189, 113, 121, 114, 145, 110...).
To run your program will be used a command similar to this one if your project is made in Go:
To run your program a command similar to this one will be used if your project is made in Go:
```sh
>$ go run your-program.go data.txt
@ -40,11 +40,13 @@ Variance: 5
Median: 4
```
Please note that the values are rounded integers.
### Testing
Your program will be tested by an auditer who will run a program provided by us, that creates a random data set of numbers and prints the result. The auditer job is to compare how your program performed.
Your program will be tested by an auditor who will run a program provided by us. This program creates a random data set of numbers and prints the result. The auditor job is to compare how your program performed.
You can choose in which language you want to build your program.
You can choose the language in which you want to build your program.
This project will help you learn about:

4
subjects/math-skills/audit/README.md

@ -4,7 +4,7 @@
###### Are the outputs of both programs (the one provided and the student one) in the same format?
###### In the output of the student program, are the data types of the values integers?
###### In the output of the student program, are the data types of the values rounded integers?
###### Did the values of both programs match?
@ -14,4 +14,4 @@
#### Bonus
###### +Did the student provided a README with explanation on how to test his/her program?
###### +Did the student provided a README with an explanation on how to test his/her program?

Loading…
Cancel
Save