small fix

color display problem in console section isn't fixed

README.md

@@ -1,4 +1,4 @@
-### Welcome to the Public Repository of 01 Edu System
+### Welcome to the Public Repository of the 01 Edu System
 
 Our courses are meticulously studied in order to provide you with quality projects.
 Please take into account our approach before making **Issues**

subjects/addifpositive/README.md

@@ -0,0 +1,43 @@
+## add-if-positive 
+
+### Instructions
+Write a function that takes two numbers and adds them together if they are both positive.
+- If either number is negative or one of them is negative and the other is positive return `0`.
+
+### Expected function 
+```go
+func AddIfPositive(a int, b int) int {
+    // your code here
+}
+```
+
+### Usage
+
+Here is a possible program to test your function:
+
+```go
+package main
+
+import "fmt"
+
+func main() {
+    fmt.Println(AddIfPositive(1, 2))
+    fmt.Println(AddIfPositive(1, -2))
+    fmt.Println(AddIfPositive(-1, 2))
+    fmt.Println(AddIfPositive(-1, -2))
+    fmt.Println(AddIfPositive(10,20))
+    fmt.Println(AddIfPositive(0,20))
+}
+```
+
+and the output should be:
+
+```console
+$ go run .
+3
+0
+0
+0
+30
+20
+```

subjects/all/README.md

@@ -2,18 +2,17 @@
 
 ### Instructions
 
-Create a function `all` that works like `Promise.all` but with objects.
-(instead of arrays)
-
-### Notions
-
-- [nan-academy.github.io/js-training/examples/promise.js](https://nan-academy.github.io/js-training/examples/promise.js)
-- [devdocs.io/javascript/global_objects/promise/all](https://devdocs.io/javascript/global_objects/promise/all)
+Create a function named `all` that works like `Promise.all` but with objects (instead of arrays).
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 Promise.all = undefined
 ```
+
+### Notions
+
+- [Promise.js](https://nan-academy.github.io/js-training/examples/promise.js)
+- [Promise.all](https://devdocs.io/javascript/global_objects/promise/all)

subjects/alphaposition/README.md

@@ -0,0 +1,46 @@
+## alpha-position
+
+### Instructions
+
+Write a function named `AlphaPosition` that takes an alphabetical character as a parameter and returns the position of the letter in the alphabet.
+- If the character is not in the alphabet, return -1
+- If the character is in the alphabet, return the position of the letter in the alphabet
+  
+### Expected function
+
+```go
+func AlphaPosition(c rune) int {
+    // your code goes here
+}
+```
+
+### Usage
+
+Here is a possible program to test your function:
+
+```go 
+package main
+
+import "fmt"
+
+func main(){
+    fmt.Println(AlphaPosition('a'))
+    fmt.Println(AlphaPosition('z'))
+    fmt.Println(AlphaPosition('B'))
+    fmt.Println(AlphaPosition('Z'))
+    fmt.Println(AlphaPosition('0'))
+    fmt.Println(AlphaPosition(' '))
+}
+```
+
+And its output : 
+
+```console
+$ go run . | cat -e
+1$
+26$
+2$
+26$
+-1$
+-1$
+```

subjects/arraysum/README.md

@@ -0,0 +1,43 @@
+## array-sum
+
+### Instructions
+
+Write a function that takes an array of numbers and returns the sum of all the numbers in the array.
+- If the array is empty, the function should return 0.
+
+### Expected function
+
+```go
+func SumArray(numbers []int) int {
+    // your code here
+}
+```
+
+### Usage
+
+Here is a possible program to test your function:
+
+```go
+package main
+
+import (
+    "fmt"
+)
+
+func main(){
+    fmt.Println(SumArray([]int{1,2,3,4,5}))
+    fmt.Println(SumArray([]int{}))
+    fmt.Println(SumArray([]int{-1,-2,-3,-4,-5}))
+    fmt.Println(SumArray([]int{-1,2,3,4,-5}))
+}
+```
+
+and the output should be:
+
+```console
+$ go run . 
+15
+0
+-15
+3
+```

subjects/ascii-art/README.md

@@ -156,6 +156,24 @@ student$ go run . "Hello\nThere" | cat -e
    |_|    |_| |_|   \___|  |_|      \___| $
                                           $
                                           $
+student$ go run . "Hello\n\nThere" | cat -e
+ _    _           _    _           $
+| |  | |         | |  | |          $
+| |__| |   ___   | |  | |    ___   $
+|  __  |  / _ \  | |  | |   / _ \  $
+| |  | | |  __/  | |  | |  | (_) | $
+|_|  |_|  \___|  |_|  |_|   \___/  $
+                                   $
+                                   $
+$
+ _______   _                              $
+|__   __| | |                             $
+   | |    | |__      ___    _ __     ___  $
+   | |    |  _ \    / _ \  | '__|   / _ \ $
+   | |    | | | |  |  __/  | |     |  __/ $
+   |_|    |_| |_|   \___|  |_|      \___| $
+                                          $
+                                          $
 student$
 ```
 

subjects/ascii-art/audit/README.md

@@ -85,6 +85,30 @@
 
 ###### Does it display the right graphical representation in ASCII as above?
 
+##### Try passing `"Hello\n\nThere"` as an argument.
+
+```
+ _    _          _   _          $
+| |  | |        | | | |         $
+| |__| |   ___  | | | |   ___   $
+|  __  |  / _ \ | | | |  / _ \  $
+| |  | | |  __/ | | | | | (_) | $
+|_|  |_|  \___| |_| |_|  \___/  $
+                                $
+                                $
+$
+ _______   _                           $
+|__   __| | |                          $
+   | |    | |__     ___   _ __    ___  $
+   | |    |  _ \   / _ \ | '__|  / _ \ $
+   | |    | | | | |  __/ | |    |  __/ $
+   |_|    |_| |_|  \___| |_|     \___| $
+                                       $
+                                       $
+```
+
+###### Does it display the right graphical representation in ASCII as above?
+
 ##### Try passing `"{Hello & There #}"` as an argument.
 
 ```

subjects/ascii/README.md

@@ -0,0 +1,38 @@
+## ascii
+
+### Instructions
+
+Write a function that receives a string and returns a slice with the ASCII values of its characters. If the string is empty it should return an empty slice.
+
+### Expected function
+
+```go
+func Ascii(str string) []byte {
+
+}
+```
+
+### Usage
+
+Here is a possible program to test your function:
+
+```go
+package main
+
+import (
+    "piscine"
+    "fmt"
+)
+
+func main() {
+    l := piscine.Ascii("Hello")
+    fmt.Println(l)
+}
+```
+
+And its output:
+
+```console
+$ go run .
+[104 101 108 108 111]
+```

subjects/betweenus/README.md

@@ -0,0 +1,46 @@
+## between-us
+
+### Instructions
+
+Write a function named `BetweenUs` that takes 3 paramters and return : 
+- If the first paramter is between the second and third paramters, return **true** else return **false**
+- If the second parameter is bigger than the third return **false**
+
+### Expected function
+```go
+func BetweenUs(num, min, max int) bool {
+    // Your code here
+}
+```
+
+
+### Usage
+
+Here is a possible program to test your function:
+
+```go
+package main
+
+import "fmt"
+
+func main(){
+    fmt.Println(BetweenUs(1, 2, 3))
+    fmt.Println(BetweenUs(1, 1, 3))
+    fmt.Println(BetweenUs(1, 3, 3))
+    fmt.Println(BetweenUs(1, 1, 1))
+    fmt.Println(BetweenUs(1, 2, 1))
+    fmt.Println(BetweenUs(-1, -10, 0))
+}
+```
+
+and the output should be:
+
+```console
+$ go run .
+false
+true
+false
+true
+false
+true
+```

subjects/binaryaddition/README.md

@@ -0,0 +1,47 @@
+## binary-addition
+
+### Instructions
+
+Write a function named `BinaryAddition(int,int)` that takes two integers and returns the sum of the two in binary in an array of `int`.
+- If one of the integers is negative return `nil`
+- Convert the argument to binary then add the two binary numbers together
+
+### Expected function 
+```go
+func BinaryAddition(a int, b int) []int {
+    // your code here
+}
+```
+
+### Usage
+
+Here is a possible program to test your function:
+
+```go
+package main
+
+import "fmt"
+
+
+func main(){
+	fmt.Println(BinaryAddition(1, 1))
+	fmt.Println(BinaryAddition(1, 2))
+	fmt.Println(BinaryAddition(1, 3))
+	fmt.Println(BinaryAddition(2, 1))
+	fmt.Println(BinaryAddition(2, 2))
+	fmt.Println(BinaryAddition(1, 16))
+}
+```
+
+and the output should be:
+
+```console
+$ go run . 
+[1 0]
+[1 1]
+[1 0 0]
+[1 1]
+[1 0 0]
+[1 0 1]
+[1 0 0 0 1]
+```

subjects/build-brick-and-break/README.md

@@ -2,43 +2,41 @@
 
 ### Instructions
 
-Today, your mission is to build a 3-column brick tower, maintain it and finally break it!
+Today, your mission is to build a 3-column brick tower, maintain it and finally break it.
 
-- Create a function `build` which will create and display the given amount of bricks passed as argument:
+- Create a function `build` which will create and display the amount of bricks passed as argument:
 
-  - each brick has to be created as a `div` and added to the page at a regular interval of 100ms,
-  - each brick will receive a unique `id` property, like following:
+  - each brick has to be created as a `div` and added to the page at a regular interval of 100ms.
+  - each brick will receive a unique `id` property, like the following:
 
   ```html
   <div id="brick-1"></div>
   ```
 
-  - each brick in the middle column has to be set with the custom data attribute `foundation` receiving the value `true`
+  - each brick in the middle column has to be set with the custom data attribute `foundation`, receiving the value `true`.
 
 - Each one of the two emojis in the top-right corner fires a function on click:
-
-  - 🔨 triggers the function `repair`: write the body of that function, which receives any number of `ids`, and for each `id`, retrieves the HTML element and set a custom attribute `repaired` set to `in progress` if it is a brick situated in the middle column, and `true` if not
-  - 🧨 triggers the function `destroy`: write the body of that function, which removes the current last brick in the tower
-
-### Notions
-
-- [`createElement()`](https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement)
-- [`append()`](https://developer.mozilla.org/en-US/docs/Web/API/ParentNode/append)
-- [Element](https://developer.mozilla.org/en-US/docs/Web/API/Element)
-- [`setInterval()`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/setInterval) / [`clearInterval()`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/clearInterval)
-- [`hasAttribute()`](https://developer.mozilla.org/en-US/docs/Web/API/Element/hasAttribute)
-- [dataset](https://developer.mozilla.org/en-US/docs/Web/API/HTMLOrForeignElement/dataset) / [`data-*`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/data-*)
-- [`remove()`](https://developer.mozilla.org/en-US/docs/Web/API/ChildNode/remove)
+  - 🔨: triggers the function `repair`. Write the body of that function. It receives any number of `ids`. For each `id`, it retrieves the HTML element, and sets the `repaired` custom attribute to `in progress` if it is a brick situated in the middle column, and `true` if not.
+  - 🧨: triggers the `destroy` function. Erite the body of that function. It removes the current last brick in the tower.
 
 ### Files
 
-You only need to create & submit the JS file `build-brick-and-break.js` ; we're providing you the following file to download (click right and save link) & test locally:
+You only need to create & submit the JS file `build-brick-and-break.js`, We're providing you the following file to download and test locally:
 
-- the HTML file [build-brick-and-break.html](./build-brick-and-break.html) to open in the browser, which includes:
-
-  - the JS script running some code, and which will also allow to run yours
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+- the HTML file [build-brick-and-break.html](./build-brick-and-break.html) can be opened in the browser, which includes:
+  - the JS script running some code, and which will enable you to run your code.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
 ### Expected result
 
 You can see an example of the expected result [here](https://youtu.be/OjSP_7u9CZ4)
+
+### Notions
+
+- [createElement](https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement)
+- [append](https://developer.mozilla.org/en-US/docs/Web/API/ParentNode/append)
+- [Element](https://developer.mozilla.org/en-US/docs/Web/API/Element)
+- [setInterval](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/setInterval) / [clearInterval](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/clearInterval)
+- [hasAttribute](https://developer.mozilla.org/en-US/docs/Web/API/Element/hasAttribute)
+- [dataset](https://developer.mozilla.org/en-US/docs/Web/API/HTMLOrForeignElement/dataset) / [data-*](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/data-*)
+- [remove](https://developer.mozilla.org/en-US/docs/Web/API/ChildNode/remove)

subjects/clonernews/README.md

@@ -1,35 +1,30 @@
 ## clonernews
 
 ### Objectives
+Technology is a rapidly evolving sector. As a programmer, it is not always easy to keep up to date with every new advancement.
 
-Technology nowadays continue to evolve. As a programmer or developer you must be updated with this exponential evolution of technology.
+Tech news (like Hacker News) is a really great way to keep up to date with the exponential evolution of technology, as well as tech jobs and much more. Some websites do not offer very appealing propositions to consume their media.
 
-This is where tech news shines, just like Hacker News where you can see all about new technology, jobs and much more, but some websites do not perform very well or their are not so appealing.
-
-So your objective for this raid is to create an UI for [`HackerNewsAPI`](https://github.com/HackerNews/API).
+So your objective for this raid is to create an UI for the [HackerNews API](https://github.com/HackerNews/API).
 
 You must handle at least:
-
-- Posts, this includes :
+- Posts: including:
   - [stories](https://github.com/HackerNews/API#ask-show-and-job-stories)
   - [jobs](https://github.com/HackerNews/API#ask-show-and-job-stories)
   - [polls](https://github.com/HackerNews/API#items)
-- [comments](https://github.com/HackerNews/API#items), each comment must have the proper post parent.
+- [comments](https://github.com/HackerNews/API#items): each comment must have the proper post parent.
 
 Post and comments must be ordered by newest post to oldest.
-You must not load all posts at once. You must be able to load posts when ever the users need to see more posts. This can be done with the help of [event](https://developer.mozilla.org/en-US/docs/Web/Events).
-
-[Live Data](https://github.com/HackerNews/API#live-data) : is one of the features from this Hacker News API, you can handle requests so that the news you provide are updated.
-
-- You must have a section that present the newest information. You will have to notify the user at least every 5 seconds, whenever the live data is updated. In other words, after every 5 seconds if a change was made in the live data, you have to notify the user.
+You must not load all posts at once, so that you only load posts once the users need to see more posts. This can be done with the help of [events](https://developer.mozilla.org/en-US/docs/Web/Events).
 
-Currently this API does not present [rate limit](https://en.wikipedia.org/wiki/Rate_limiting). But that does not mean you should abuse/overload the API!!!
+The point of the project is to keep users updated, so we'll need to inform our users of changes to the data using [Live Data](https://github.com/HackerNews/API#live-data). Create a section that presents the newest information. You'll need to notify the user at least every 5 seconds, whenever the live data is updated.
 
-Best ways you can avoid rate limiting :
+Currently this API does not present a [rate limit](https://en.wikipedia.org/wiki/Rate_limiting), but that does not mean that you should abuse or overload the API.
 
+Best ways you can avoid rate limiting:
 - optimize your code to eliminate any unnecessary requests
-- usage of throttling/debouncing function to regulates the amount of requests
+- usage of a throttling/debouncing function to regulate the number of requests,
 
 ### Optional
 
-You can handle sub-comments for each stories, jobs and polls this meaning nested comments
+You can handle sub-comments for stories, jobs and polls, by implementing nested comments.

subjects/clonernews/audit/README.md

@@ -1,20 +1,20 @@
-#### Functionals
+#### Functional
 
 ##### Try to open a story post
 
-###### Does this post open without problems?
+###### Does this post open without any errors?
 
 ##### Try to open a job post
 
-###### Does this post open without problems?
+###### Does this post open without any errors?
 
 ##### Try to open a poll post
 
-###### Does this post open without problems?
+###### Does this post open without any errors?
 
 ##### Try to load more posts
 
-###### Did the posts loaded without error or without spamming the user?
+###### Did the posts load without error and without spamming the user?
 
 ##### Try to open a post with comments
 
@@ -24,16 +24,16 @@
 
 ###### Does the UI have at least stories, jobs and polls?
 
-###### Are the posts displayed in the correct order(from newest to oldest)?
+###### Are the posts displayed in the correct order (from newest to oldest)?
 
 ###### Does each comment present the right parent post?
 
-###### Is the UI notifying the user that there is a new update on a certain post?
+###### Does the UI notify the user when a certain post is updated?
 
-###### Is the project using Throttle to regulate the amount of request (every 5 seconds)?
+###### Is the project using throttling to regulate the number of requests (every 5 seconds)?
 
 #### Bonus
 
 ###### +Does the UI have more types of posts than stories, jobs and polls?
 
-###### +Are there sub-comments(nested comments) on the UI?
+###### +Have sub-comments (nested comments) been implemented?

subjects/countnegative/README.md

@@ -0,0 +1,40 @@
+## count-negative
+
+### Instructions 
+
+Write a function that takes an array of integers and returns the number of negative numbers in the array.
+- If the array is empty, the function should return `0`.
+
+### Expected function 
+```go 
+func CountNegative(numbers []int) int {
+    // your code here
+}
+```
+
+### Usage 
+
+Here is a possible program to test your function:
+
+```go
+package main 
+
+import "fmt"
+
+func main(){
+    fmt.Println(CountNegative([]int{1, 2, 3, 4, 5, 6, 7, 8, 9, 10}))
+    fmt.Println(CountNegative([]int{-1, -2, -3, -4, -5, -6, -7, -8, -9, -10}))
+    fmt.Println(CountNegative([]int{}))
+    fmt.Println(CountNegative([]int{-1,2,0,-3}))
+}
+```
+
+and the output should be:
+
+```console
+$ go run . 
+0
+10
+0
+2
+```

subjects/curry-entries/README.md

@@ -2,18 +2,20 @@
 
 ### Instructions
 
-This exercise consists in creating curry functions to apply in the object's entries.
-You will have to create the following curry functions:
+You're going to create some curry functions, to apply to the object's entries.
 
-- `defaultCurry` curries two objects in which the second object overrides the values of the first. If the key is not present then add it with the corresponding value.
+Create `defaultCurry`, which curries two objects. It mergers the objects together. If the key exists in both objects, the value from the second object override the value from the first object.
 
 ```js
-
 defaultCurry({
   http: 403,
   connection: 'close',
   contentType: 'multipart/form-data',
-})({ http: 200, connection: 'open', requestMethod: 'GET' })
+})({
+  http: 200,
+  connection: 'open',
+  requestMethod: 'GET'
+})
 // output
 {
     http: 200,
@@ -24,7 +26,7 @@ defaultCurry({
 
 ```
 
-- `mapCurry` replicates function `.map`, where first entry is a function, second is an object.
+Create `mapCurry`, which replicates function `.map` (but for an object). The first entry is the function, and the second entry is the object.
 
 ```js
 mapCurry(([k, v]) => [`${k}_force`, v])(personnel)
@@ -38,7 +40,7 @@ mapCurry(([k, v]) => [`${k}_force`, v])(personnel)
 }
 ```
 
-- `reduceCurry` replicates function `.reduce`, where first entry is function, second is (object, initial value).
+Create `reduceCurry`, which replicates the `.reduce` method (but fro an object). The first entry is the function, and the second is the object and initial value).
 
 ```js
 reduceCurry((acc, [k, v]) => (acc += v))({ a: 1, b: 2, c: 3 }, 0)
@@ -46,7 +48,7 @@ reduceCurry((acc, [k, v]) => (acc += v))({ a: 1, b: 2, c: 3 }, 0)
 6
 ```
 
-- `filterCurry` replicates function `.filter`, where first entry is function, second is object.
+Create `filterCurry` which replicates the `.filter` method (but for an object). The first entry is the function, and the second is an object.
 
 ```js
 filterCurry(([k, v]) => typeof v === 'string' || k === 'arr')({
@@ -60,25 +62,14 @@ filterCurry(([k, v]) => typeof v === 'string' || k === 'arr')({
 
 Using each curry function create the following functions with a parameter `personnel`:
 
-- `reduceScore` that will return the total value of the scores
-  of the persons who use the force (this function can have one additional parameter)
-- `filterForce` that will return the force users with `shootingScores`
-  equal or higher than 80
-- `mapAverage` that will return a new object with the propriety `averageScore`
-  that is the average of the scores for each person
-
-### Notions
-
-- [devdocs.io/javascript/global_objects/array/filter](https://devdocs.io/javascript/global_objects/array/filter)
-- [devdocs.io/javascript/global_objects/array/map](https://devdocs.io/javascript/global_objects/array/map)
-- [devdocs.io/javascript/global_objects/array/reduce](https://devdocs.io/javascript/global_objects/array/reduce)
-- [devdocs.io/javascript/global_objects/object/entries](https://devdocs.io/javascript/global_objects/object/entries)
-- [devdocs.io/javascript/global_objects/object/fromentries](https://devdocs.io/javascript/global_objects/object/fromentries)
-- [stackoverflow.com/questions/36314/what-is-currying](https://stackoverflow.com/questions/36314/what-is-currying)
+- `reduceScore`: that will return the total value of the scores
+  of the people who use the force. (this function can have one additional parameter).
+- `filterForce`: that will return the force users with `shootingScores` equal to or higher than 80.
+- `mapAverage`: that will return a new object with the property `averageScore`, that is the average of the scores for each person.
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 // prettier-ignore
@@ -90,3 +81,12 @@ const personnel = {
   calebDume:     { id: 11, pilotingScore: 71, shootingScore: 85, isForceUser: true  },
 }
 ```
+
+### Notions
+
+- [filter](https://devdocs.io/javascript/global_objects/array/filter)
+- [map](https://devdocs.io/javascript/global_objects/array/map)
+- [reduce](https://devdocs.io/javascript/global_objects/array/reduce)
+- [entries](https://devdocs.io/javascript/global_objects/object/entries)
+- [fromentries](https://devdocs.io/javascript/global_objects/object/fromentries)
+- [stackoverflow what-is-currying?](https://stackoverflow.com/questions/36314/what-is-currying)

subjects/debounce/README.md

@@ -2,12 +2,12 @@
 
 ### Instructions
 
-Create two functions that will work like `_.debounce` from lodash
+Create two functions that will work like `_.debounce` from lodash.
 
-- `debounce`, this function doesn't need to take care of the options
-- `opDebounce`, this function will take care of the `leading` options
+- `debounce`: don't worry about the options.
+- `opDebounce`: implement the `leading` options.
 
 ### Notions
 
-- [lodash.com/docs/4.17.15#debounce](https://lodash.com/docs/4.17.15#debounce)
-- [https://css-tricks.com/debouncing-throttling-explained-examples/#debounce](https://css-tricks.com/debouncing-throttling-explained-examples/#debounce)
+- [lodash debounce](https://lodash.com/docs/4.17.15#debounce)
+- [css-tricks.com debounce](https://css-tricks.com/debouncing-throttling-explained-examples/#debounce)

subjects/deep-copy/README.md

@@ -2,7 +2,7 @@
 
 ### Instructions
 
-Create a function called `deepCopy` that copy objects and arrays recursively.
+Create a function named `deepCopy` that copies objects and arrays recursively.
 
 ### Notions
 

subjects/divisors/README.md

@@ -0,0 +1,41 @@
+## Devisor
+
+### Instructions
+
+Write a function that takes a positive  integer and returns the number of it's devisors.
+- If the the number a is negative return 0.
+- Test numbers from 0 to 99999999 .
+
+### Expected function
+```go
+func Divisors(n int) int {        
+    ...
+}
+```
+### Usage
+
+Here is a possible program to test your function:
+
+```go
+package main
+
+import (
+    "fmt"
+    "piscine"
+)
+
+func main() {
+    fmt.Println(piscine.Divisors(4))// 4 can be divided by 1 and 2 and 4
+    fmt.Println(piscine.Divisors(5))//5 can be divided by 1 and 5
+}
+
+```
+
+And its output :
+
+
+```console
+$ go run .
+3 
+2 
+```

subjects/events/README.md

@@ -7,28 +7,28 @@ You have to design a notification system for a platform.
 Depending on the type of event, your event handler will control the size, color and position of the notification.
 
 Create a method named `notify` which returns a `Notification` with the following characteristics for each of:
-- `Remainder`:
+- `Remainder(text)`:
   - `size`: `50`
   - `color`: `(50, 50, 50)`
   - `position`: `Bottom`
-  - `content`: the slice associated to the enum value.
+  - `content`: the `text` associated to the enum variant
 - `Registration(chrono::Duration)`:
   - `size`: `30`
   - `color`: `(255, 2, 22)`
   - `position`: `Top`
   - `content`: `"You have {duration} left before the registration ends"`
-- `Appointment(text)`
-  - `size: 100`
-  - `color: (200, 200, 3)`
-  - `position: Center`
-  - `content: text associated to the value`
-- `Holiday`
+- `Appointment(text)`:
+  - `size`: `100`
+  - `color`: `(200, 200, 3)`
+  - `position`: `Center`
+  - `content`: `text associated to the value`
+- `Holiday`:
   - `size`: `25`
   - `color`: `(0, 255, 0)`
   - `position`: `Top`
   - `content`: `"Enjoy your holiday"`
 
-`duration` must be displayed in the form of `{hours}H:{minutes}M:{seconds}S`. The time will represent the remaining time before the event starts. For example, if there are 2 hours, 32 minutes and 3 seconds left, then the content will be `"You have 13H:38M:14S left before the registration ends"`
+`duration` must be displayed in the form of `{hours}H:{minutes}M:{seconds}S`. The time will represent the remaining time before the event starts. For example, if there are 13 hours, 38 minutes and 14 seconds left, then the content will be `"You have 13H:38M:14S left before the registration ends"`
 
 Implement the `std::fmt::Display` trait so the text of the notifications are printed in the right color in the command line.
 
@@ -37,6 +37,8 @@ Implement the `std::fmt::Display` trait so the text of the notifications are pri
 
 chrono = "0.4"
 
+colored = "2.0.0"
+
 ### Expected Functions and Data Structures
 
 ```rust
@@ -44,22 +46,22 @@ use chrono::Duration;
 use colored::*;
 
 #[derive(Debug, Eq, PartialEq)]
-enum Position {
+pub enum Position {
 	Top,
 	Bottom,
 	Center,
 }
 
 #[derive(Debug, Eq, PartialEq)]
-struct Notification {
-	size: u32,
-	color: (u8, u8, u8),
-	position: Position,
-	content: String,
+ pub struct Notification {
+	pub size: u32,
+	pub color: (u8, u8, u8),
+	pub position: Position,
+	pub content: String,
 }
 
 #[derive(Debug)]
-enum Event<'a> {
+pub enum Event<'a> {
 	Remainder(&'a str),
 	Registration(Duration),
 	Appointment(&'a str),
@@ -74,7 +76,7 @@ impl fmt::Display for Notification {
 use Event::*;
 
 impl Event {
-	fn notify(&self) -> Notification {
+	pub fn notify(&self) -> Notification {
 	}
 }
 ```

subjects/fifty-shades-of-cold/README.md

@@ -2,11 +2,11 @@
 
 ### Instructions
 
-You've been asked to freshen a webpage atmosphere by displaying shades of cold colors.
+You've been asked to freshen up a webpage, by displaying shades of cold colors.
 
 Check the `colors` array provided in the data file below.
 
-- Write the `generateClasses` function which creates a `<style>` tag in the `<head>` tag and generates, for each color of `colors`, a class setting the `background` attribute and taking the color as value, like following:
+Write the `generateClasses` function. It creates a `<style>` tag inside the `<head>`. It should generate one class for each color in the `colors` array, which sets the `background` attribute like so:
 
 ```css
 .blue {
@@ -14,33 +14,32 @@ Check the `colors` array provided in the data file below.
 }
 ```
 
-- Write the `generateColdShades` function which creates a `<div>` for each color of the `colors` array whose name contains `aqua`, `blue`, `turquoise`, `green`, `cyan`, `navy` or `purple`.\
-  Each `<div>` must have the corresponding generated class and display the name of the color, like following:
+Write the `generateColdShades` function which creates a `<div>` for each color of the `colors` array, whose name contains `aqua`, `blue`, `turquoise`, `green`, `cyan`, `navy` or `purple`. Each `<div>` must have the corresponding generated class and display the name of the color, like following:
 
 ```html
 <div class="blue">blue</div>
 ```
 
-- The function `choseShade` is triggered when clicking on a `div`.\
-  Write the body of this function, which receives the shade of the clicked element as argument, and replaces all the other elements class by the chosen shade.
-
-### Notions
-
-- [`head`](https://developer.mozilla.org/en-US/docs/Web/API/Document/head) / [style tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/style)
-- [`className`](https://developer.mozilla.org/en-US/docs/Web/API/Element/className)
-- [`classList`](https://developer.mozilla.org/en-US/docs/Web/API/Element/classList): `contains()`, `replace()`
+The function `choseShade` is triggered when clicking on a `div`. Write the body of this function. It accepts the shade of the clicked element as an argument, and replaces all the classes of all the other elements by the chosen shade.
 
 ### Files
 
-You only need to create & submit the JS file `fifty-shades-of-cold.js` ; we're providing you the following files to download (click right and save link) & test locally:
+You only need to create & submit the JS file `fifty-shades-of-cold.js`, we're providing you the following files to download and test locally:
 
 - the HTML file [fifty-shades-of-cold.html](./fifty-shades-of-cold.html) to open in the browser, which includes:
 
-  - the JS script running some code, and which will also allow to run yours
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+  - the JS script running some code, and which will enable you to run yours
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
-- the data file [fifty-shades-of-cold.data.js](./fifty-shades-of-cold.data.js) from which you can import `colors`
+- the data file [fifty-shades-of-cold.data.js](./fifty-shades-of-cold.data.js) from which you can import `colors`.
 
 ### Expected result
 
 You can see an example of the expected result [here](https://youtu.be/a-3JDEvW-Qg)
+
+### Notions
+
+- [head tag](https://developer.mozilla.org/en-US/docs/Web/API/Document/head)
+- [style tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/style)
+- [className](https://developer.mozilla.org/en-US/docs/Web/API/Element/className)
+- [classList](https://developer.mozilla.org/en-US/docs/Web/API/Element/classList): `contains()`, `replace()`

subjects/filter/README.md

@@ -2,25 +2,25 @@
 
 ### Instructions
 
-- Create a `filter` function that takes an array as first argument, a function as second,
-  and that works like the method [].filter
 
-- Create a `reject` function that takes an array as first argument, a function as second,
-  and that works like the reject function from lodash.
+Create the following functions, which each take an array as the first argument, and a function as the second argument.
 
-- Create a `partition` function that takes an array as first argument, a function as second,
-  and that works like the partition function from lodash.
+- `filter`: that works like the `[].filter` method.
 
-### Notions
+- `reject`: that works like the `reject` function from lodash.
 
-- [devdocs.io/javascript/global_objects/array/filter](https://devdocs.io/javascript/global_objects/array/filter)
-- [lodash.com/docs/4.17.15#reject](https://lodash.com/docs/4.17.15#reject)
-- [lodash.com/docs/4.17.15#partition](https://lodash.com/docs/4.17.15#partition)
+- `partition`: that works like the `partition` function from lodash.
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 Array.prototype.filter = undefined
 ```
+
+### Notions
+
+- [devdocs.io/javascript/global_objects/array/filter](https://devdocs.io/javascript/global_objects/array/filter)
+- [lodash.com/docs/4.17.15#reject](https://lodash.com/docs/4.17.15#reject)
+- [lodash.com/docs/4.17.15#partition](https://lodash.com/docs/4.17.15#partition)

subjects/flagger/README.md

@@ -2,14 +2,13 @@
 
 ### Instructions
 
-Create a function called `flags` that receives an object and returns
-the specific aliases and descriptions from the properties of that object.
+Create a function named `flags` that receives an object and returns the specific aliases and descriptions from the properties of that object.
 
 The `help` flag:
 
-- Should be present in the output by default.
+- Must be present in the **output** by default.
 - When not present in the input, it should return the description of all flags.
-  But when present it specifies the descriptions of the flags that are passed to help. (ex: `help: ['divide']`)
+- When present in the input, it specifies the descriptions of the flags that are passed to `help`. (ex: `help: ['divide']`)
 
 #### Example:
 

subjects/flow/README.md

@@ -2,8 +2,7 @@
 
 ### Instructions
 
-Create the function `flow` that will works as the \_.flow([funcs])
-from lodash.
+Create the function named `flow` that will like the `_.flow([funcs])` from lodash.
 
 ### Example
 

subjects/for-each/README.md

@@ -2,16 +2,16 @@
 
 ### Instructions
 
-Create a `forEach` function that takes an array as first argument, a function as second,
-and that works like the method .forEach
+Create a function named `forEach` which takes an array as the first argument, a function as the second argument,
+and that works like the `Array.prototype.forEach` method.
 
 ### Notions
 
-- [devdocs.io/javascript/global_objects/array/foreach](https://devdocs.io/javascript/global_objects/array/foreach)
+- [Array.prototype.forEach](https://devdocs.io/javascript/global_objects/array/foreach)
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 Array.prototype.forEach = undefined

subjects/fusion/README.md

@@ -2,38 +2,38 @@
 
 ### Instructions
 
-The objective of this exercise is to merge objects into a new object depending on the values type
+The objective of this exercise is to merge objects into a new object depending on the values type.
 
-With this, create a function called `fusion` that:
+Create a function named `fusion` that:
 
-- If the type is an array you must concatenate it
+- For array types, you will concatenate them.
 
 ```js
 fusion({ arr: [1, "2"] }, { arr: [2] }); // -> { arr: [ 1, '2', 2 ] }
 fusion({ arr: [], arr1: [5] },{ arr: [10, 3], arr1: [15, 3], arr2: ["7", "1"] }); // ->{ arr: [ 10, 3 ], arr1: [ 5, 15, 3 ], arr2: [ '7', '1' ] }
 ```
 
-- If it is a string you must concatenate it with a space
+- For strings, you must concatenate them with a space.
 
 ```js
 fusion({ str: "salem" }, { str: "alem" }); // -> { str: 'salem alem' }
 fusion({ str: "salem" }, { str: "" }); // -> { str: 'salem ' }
 ```
 
-- If they are numbers, you must add them
+- If they are numbers, you must add them.
 
 ```js
 fusion({ a: 10, b: 8, c: 1 }, { a: 10, b: 2 }); // -> { a: 20, b: 10, c: 1 }
 ```
 
-- If it is an object, you must join them recursively
+- If it is an object, you must join them recursively.
 
 ```js
 fusion({ a: 1, b: { c: "Salem" } }, { a: 10, x: [], b: { c: "alem" } }); // -> { a: 11, x: [], b: { c: 'Salem alem' } }
 fusion( { a: { b: [3, 2], c: { d: 8 } } },{ a: { b: [0, 3, 1], c: { d: 3 } } }); // -> { a: { b: [ 3, 2, 0, 3, 1 ], c: { d: 11 } } }
 ```
 
-- In case of type mismatch you must replace it with the value of the second object
+- In case of type mismatch you must replace it with the value of the second object (if it exists).
 
 ```js
 fusion({ a: "hello", b: [] }, { a: 4 }); // -> { a: 4, b: [] }

subjects/get-json/README.md

@@ -4,26 +4,23 @@
 
 In this exercise, we will focus on building complex async flows with promises.
 
-Create a `getJSON` function that takes 2 parameters:
+Create a function named `getJSON` with two parameters:
+- `path`: a URL called by your function.
+- `params`: optional query parameters that will be appended to the `path`.
 
-- `path`, that will be the url called by your function
-- `params` _optional_, that will be the search parameters appended to your url
+`getJSON` must construct a valid url with the `path` and stringified `params`, and use `fetch` to fulfil the request.
 
-`getJSON` must construct a valid url with the `path` and stringified `params`
-and call `fetch` with it.
-If the response is not ok, your function must throw an error using
-the response status message.
+If the response is not OK, `getJSON` must throw an error using the response _status text_.
 
-The response body must then be read and parsed from json.
+The response body must then be read and parsed from JSON.
 
 The parsed object contains one of those 2 properties:
-
-- `"data"` the actual data to return
-- `"error"` the error message to throw
+- `"data"`: the actual data to return.
+- `"error"`: the error message to throw.
 
 ### Notions
 
-- [nan-academy.github.io/js-training/examples/promise.js](https://nan-academy.github.io/js-training/examples/promise.js)
-- [devdocs.io/dom/fetch_api/using_fetch](https://devdocs.io/dom/fetch_api/using_fetch)
-- [devdocs.io/dom/urlsearchparams](https://devdocs.io/dom/urlsearchparams)
-- [devdocs.io/javascript/global_objects/json](https://devdocs.io/javascript/global_objects/json)
+- [Promise.js](https://nan-academy.github.io/js-training/examples/promise.js)
+- [Using fetch](https://devdocs.io/dom/fetch_api/using_fetch)
+- [URL search params](https://devdocs.io/dom/urlsearchparams)
+- [JSON](https://devdocs.io/javascript/global_objects/json)

subjects/get-them-all/README.md

@@ -2,52 +2,55 @@
 
 ### Instructions
 
-You've been attributed the task to find the main architect of the Tower of Pisa before he achieves his plans, avoiding us nowadays all those lame pictures of people pretending to stop it from falling.
+You've been given the task of finding the main architect of the Tower of Pisa before he achieves his plans; avoiding all those lame pictures of people pretending to stop it from falling.
 
-You arrive at the architects' chamber to find him, but all you have in front of you is a bunch of unknown people.
-Step by step, with the little information you have, gather information and figure out by elimination who he is.
+You arrive at the architects' chamber, but all you have in front of you is a bunch of unknown people.
 
-Launch the provided HTML file in the browser to begin your investigation.<br/>
-On top of the webpage, each of the four buttons fires a function:
+Step by step, gather information and figure out by elimination who he is.
 
-- Write the body of the `getArchitects` function, which returns an array containing 2 arrays of HTML elements:
+Launch the provided HTML file in the browser to begin your investigation.
 
-  - the first array contains the architects, all corresponding to a `<a>` tag
-  - the second array contains all the non-architects people
+At the top of the webpage, each of the four buttons fires a function:
 
-- Write the body of the `getClassical` function, which returns an array containing 2 arrays of HTML elements:
+Complete the body of the following functions. The first three functions return an array containing two arrays of HTML elements:
 
-  - the first array contains the architects belonging to the `classical` class
-  - the second array contains the non-classical architects
+- `getArchitects`:
+  - 1st array: the architects, all corresponding to a `<a>` tag.
+  - 2nd array: all the non-architects.
 
-- Write the body of the `getActive` function, which returns an array containing 2 arrays of HTML elements:
+- `getClassical`:
+  - 1st array: the architects belonging to the `classical` class.
+  - 2nd array: the non-classical architects.
 
-  - the first array contains the classical architects who are `active` in their class
-  - the second array contains the non-active classical architects
+- `getActive`:
+  - 1st array: the classical architects who are `active` in their class.
+  - 2nd array: the non-active classical architects.
 
-- Write the body of the `getBonannoPisano` function, which returns an array containing:
-  - the HTML element of the architect you're looking for, whose `id` is `BonannoPisano`
-  - an array which contains all the remaining HTML elements of active classical architects
-
-> From now on, don't forget to [**export**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/export) all the expected functions, so that they can be imported to be tested<br/> > `export const getArchitects = () => {...}`
-
-### Notions
-
-- [HTML Element](https://developer.mozilla.org/en-US/docs/Web/API/Element)
-- [`getElementsByTagName()`](https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByTagName)
-- [`getElementsByClassName()`](https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName)
-- [`getElementById()`](https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementById)
-- [`querySelectorAll()`](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll) / [`querySelector()`](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector)
-- ...and bit of CSS that could help with the [`:not` pseudo class](https://developer.mozilla.org/en-US/docs/Web/CSS/:not)
+The last function is `getBonannoPisano`. It returns an array containing:
+  - the HTML element of the architect you're looking for, whose `id` is `BonannoPisano`.
+  - an array containing all the remaining HTML elements of active classical architects.
 
+> From now on, don't forget to [**export**](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/export) all the expected functions, so that they can be imported to be tested.
+```js
+export const getArchitects = () => {...}
+```
 ### Files
 
-You only need to create & submit the JS file `get-them-all.js` ; we're providing you the following files to download (click right and save link) & test locally:
+You only need to create & submit the JS file `get-them-all.js`. We're providing you the following files to download. You may test them locally:
 
 - the HTML file [get-them-all.html](./get-them-all.html) to open in the browser, which includes:
 
-  - the JS script running some code, and which will also allow to run yours
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
-  - the import of the data
+  - the JS script running some code, and which will allow you to run your code.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
+  - an import of the data.
 
-- the data file [get-them-all.data.js](./get-them-all.data.js) used to generate content in the HTML
+- the data file [get-them-all.data.js](./get-them-all.data.js) used to generate content in the HTML.
+
+### Notions
+
+- [HTML Element](https://developer.mozilla.org/en-US/docs/Web/API/Element)
+- [getElementsByTagName](https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByTagName)
+- [getElementsByClassName](https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName)
+- [getElementById](https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementById)
+- [querySelectorAll](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll) / [querySelector`](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector)
+- ...and bit of CSS that could help with the [`:not` pseudo class](https://developer.mozilla.org/en-US/docs/Web/CSS/:not)

subjects/getarea/README.md

@@ -0,0 +1,25 @@
+## get-area
+
+### Instructions
+
+Write a program that takes a positive number as radius and prints the area of a circle.
+  - The area of the circle is `3.14` times the radius squared.
+  - Only positive numbers will be accepted, otherwise print `Error` followed by (`'\n'`)
+  - If the number of arguments is not `1` print (`'\n'`)
+  - The output must be an integer.
+
+
+###  Usage
+
+```console
+$ go run . | cat -e
+$
+$ go run . 10 | cat -e
+314$
+$ go run . 4 | cat -e
+50$
+$ go run . -10 | cat -e
+Error$
+$ go run . "Hello World!" | cat -e
+Error$
+```

subjects/gossip-grid/README.md

@@ -2,37 +2,37 @@
 
 ### Instructions
 
-Good information is the pillar of society, that's why you've decided to dedicate your time to reveal the powerful truth to the world and deliver essential and strong news: you're launching a gossip grid.
-
 Create the function `grid` which displays all the `gossips`, provided in the data file below, as cards on a grid (in the same order).
-They must be `div` with the `gossip` class.
-
-The first `gossip` card must be a `form` with a `textarea` and a submit button with the text `Share gossip!` that allows to add a new gossip to the list.
 
-Create 3 `type="range"` inputs with the class `range`, all wrapped in a `div` with the class `ranges`:
+They will each be represented as a `div` with the `gossip` class.
 
-- one with `id="width"` that control the width of cards _(from 200 to 800 pixels)_
-- one with `id="fontSize"` that control the font size _(from 20 to 40 pixels)_
-- one with `id="background"` that control the background lightness _(from 20% to 75%)_
+The first `gossip` card must be a `form`. It will need a `textarea`, and a submit button with the text `"Share gossip!"`. It will add new gossip to the list.
 
-> _tips:_ use `hsl` for colors
-
-### Notions
+Create 3 `type="range"` inputs with the class `range`, all wrapped in a `div` with the class `ranges`.
+- `id="width"`: that controls the width of cards from 200 to 800 pixels.
+- `id="fontSize"`: that controls the font size from 20 to 40 pixels.
+- `id="background"`: that control the background lightness from 20% to 75%.
 
-- [`<form>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Form)
-- [`<input>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Input): [`text`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/text), [`range`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/range)
+> Use `hsl` for colors
 
 ### Files
 
-You only need to create & submit the JS file `gossip-grid.js` ; we're providing you the following files to download (click right and save link) & test locally:
+You only need to create & submit the JS file `gossip-grid.js`; we're providing you the following files to download and test locally:
 
 - the HTML file [gossip-grid.html](./gossip-grid.html) to open in the browser, which includes:
 
-  - the JS script which will allow to run your code
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+  - the JS script which will enable you to run your code.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
-- the data file [gossip-grid.data.js](./gossip-grid.data.js) from which you can import `gossips`
+- the data file [gossip-grid.data.js](./gossip-grid.data.js) from which you can import `gossips`.
 
 ### Expected result
 
 You can see an example of the expected result [here](https://youtu.be/nbR2eHBqTxU)
+
+### Notions
+
+- [form](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Form)
+- [input](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Input)
+- [text](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/text)
+- [range](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/range)

subjects/gougle-search/README.md

@@ -2,16 +2,11 @@
 
 ### Instructions
 
-Create the `queryServers` function, that takes 2 arguments:
-
-- `serverName` a string of the name of the server
-- `q` a string of the query given by the user
-
-You have to construct 2 urls, using `q` as a search parameter,
-prepending a `'/'` and for the 2nd appending `'_backup'`.
-
-Then return the first value of those 2 calls
+Create a function named `queryServers` that takes 2 arguments:
+- `serverName`: a string of the name of the server.
+- `q`: a string of the query given by the user.
 
+You need to construct 2 urls which should work like this:
 ```js
 queryServers('pouet', 'hello+world')
 // return the fastest of those 2 calls:
@@ -19,25 +14,26 @@ queryServers('pouet', 'hello+world')
 // -> getJSON('/pouet_backup?q=hello+world')
 ```
 
-Create a `gougleSearch` function that takes a single query argument.
-It must call `queryServers` in concurrently on 3 servers:
-`'web'`, `'image'` and `'video'`.
-
-A timeout of 80milliseconds must be set for the whole operation.
+Create a function named: `gougleSearch` that takes a single query argument (`q`). It must invoke `queryServers` concurrently on 3 servers:
+- `"web"`
+- `"image"`
+- `"video"`
 
-You must return the value from each server in an object
-using  the server name as key.
+You must return the value from each server in an object using  the server name as key.
 
-### Notions
+A timeout of 80milliseconds must be set for the whole operation, if it is not complete within 80 milliseconds, then you must return `Error('timeout')`.
 
-- [devdocs.io/javascript/global_objects/promise/race](https://devdocs.io/javascript/global_objects/promise/race)
-- [devdocs.io/javascript/global_objects/promise/all](https://devdocs.io/javascript/global_objects/promise/all)
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 // fake `getJSON` function
 let getJSON = async (url) => url
 ```
+
+### Notions
+
+- [Promise.race](https://devdocs.io/javascript/global_objects/promise/race)
+- [Promise.all](https://devdocs.io/javascript/global_objects/promise/all)

subjects/harder-bigger-bolder-stronger/README.md

@@ -2,27 +2,26 @@
 
 ### Instructions
 
-Being stuck at home, bored, desperate and coming up with a lot of weird ideas, a friend asks you to develop a tool to measure his ocular skills: one of those [Monoyer charts](https://en.wikipedia.org/wiki/Monoyer_chart) that ophthalmologists use.
+Being stuck at home, bored, desperate and coming up with a lot of weird ideas, a friend asks you to develop a tool to measure his ocular skills. One of those [Monoyer charts](https://en.wikipedia.org/wiki/Monoyer_chart) that ophthalmologists use.
 
-Generate a board where each new letter is harder, bigger, bolder and stronger!
+Generate a board where each new letter is harder, bigger, bolder and stronger.
 
-Write the function `generateLetters` which creates 120 `div`, each containing a letter randomly picked through the **uppercase** alphabet, and whose style properties have to be increased:
-
-- each letter `font-size` has to grow from `11` to `130` pixels
-- `font-weight` has to be `300` for the first third of the letters, `400` for the second third, and `600` for the last third
+Write the function `generateLetters` which creates 120 `div` elements, each containing a letter randomly picked through the **uppercase** alphabet, and whose style properties have to be increased:
+- each letter's `font-size` has to grow from `11` to `130` pixels.
+- `font-weight` has to be `300` for the first third of the letters, `400` for the second third, and `600` for the last third.
 
 ### Files
 
-You only need to create & submit the JS file `harder-bigger-bolder-stronger.js` ; we're providing you the following file to download (click right and save link) & test locally:
+You only need to create & submit the JS file `harder-bigger-bolder-stronger.js`. We're providing you the following file to download and test locally:
 
 - the HTML file [harder-bigger-bolder-stronger.html](./harder-bigger-bolder-stronger.html) to open in the browser, which includes:
 
-  - the JS script running some code, and which will also allow to run yours
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+  - the JS script running some code, and which will enable you to run yours.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
 ### Notions
 
-- [`createElement()`](https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement)
-- [`append()`](https://developer.mozilla.org/en-US/docs/Web/API/ParentNode/append)
-- [`style`](https://developer.mozilla.org/en-US/docs/Web/API/ElementCSSInlineStyle/style)
-- [`textContent`](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent)
+- [createElement](https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement)
+- [append](https://developer.mozilla.org/en-US/docs/Web/API/ParentNode/append)
+- [style](https://developer.mozilla.org/en-US/docs/Web/API/ElementCSSInlineStyle/style)
+- [textContent](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent)

subjects/interpolation/README.md

@@ -2,14 +2,15 @@
 
 ### Instructions
 
-Create a function called `interpolation` that takes an object with 5 properties
-`step`, `start`, `end`, `callback` and `duration`.
-This function must calculate the interpolation points, (x, y),
-from the `start` position to `end` position depending on the number of steps.
-All the points must be calculated in the duration time.
+Create a function named `interpolation` that takes an object with 5 properties: `step`, `start`, `end`, `callback` and `duration`.
 
-For each interpolation point you must call `callback` function with parameter - interpolation point ([x, y]).
-Each interpolation point should be calculated with interval of `duration / step`.
+This function must interpolate points from the `start` position to the `end` position (not including the `end` position). The number of points depends on the number of steps.
+
+For each interpolation point, you must call the `callback` function with an array of the two points `[x, y]`:
+- `x`: distance
+- `y`: point
+
+There should be a delay between each `callback` invocation; of `duration / step`, so that the final call happens after `duration`.
 
 ### Example
 
@@ -41,4 +42,4 @@ duration = 10
 
 ### Notions
 
-- [javascript.info/settimeout-setinterval](https://javascript.info/settimeout-setinterval)
+- [setTimeout & setInterval](https://javascript.info/settimeout-setinterval)

subjects/invert/README.md

@@ -2,8 +2,8 @@
 
 ### Instructions
 
-Create a function called `invert` that takes an object and returns it with its keys and values inverted.
+Create a function named `invert` which takes an object and returns it with its keys and values inverted.
 
 ### Notions
 
-- [devdocs.io/javascript/global_objects/object](https://devdocs.io/javascript/global_objects/object)
+- [object](https://devdocs.io/javascript/global_objects/object)

subjects/is-winner/README.md

@@ -2,27 +2,23 @@
 
 ### Instructions
 
-Create a function `isWinner` that, by making use of `winners` "API", should
-return a resolved Promise with the string:
+Create a function named `isWinner` which accepts a string representing the name of a country. It should use the `winners` _"API"_ to return a resolved `Promise` with an appropriate string.
 
-- `<country> + ' never was a winner'`, if the country passed in `isWinner` has never won  the FIFA World Cup
+The strings which can be returned are listed below. You'll need to replace `"Country"` with the country named which is passed to `isWinner`:
 
-- `<country> + ' is not what we are looking for because of the continent'`,
-  if the country passed in `isWinner` is not from the european
-  continent
+- `"Country never was a winner"`: The country has never won a FIFA world cup.
 
-- `<country> + ' is not what we are looking for because of the number of times it was champion'`, if the country passed in `isWinner` was champion
-  less than 3 times
+- `"Country is not what we are looking for because of the continent"`: The country is not from the european continent.
 
-- `<country> + ' won the FIFA World Cup in ' + <year(s)> + 'winning by ' + <results>`, otherwise.
+- `"Country is not what we are looking for because of the number of times it was champion"`: The country won the FIFA world cup fewer than 3 times.
 
-The years and results should be displayed like bellow:
-
-```<country> + ' won the FIFA World Cup in 1000, 1004, 1008 winning by 4-3, 5-2, 1-0```
+- `"Country won the FIFA World Cup in <years> winning by <results>"`: with the following format:
+  - `<years>`: `"1000, 1004, 1008"`
+  - `<results>`: `"4-3, 5-2, 1-0"`
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submitted.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 const db = (() => {

subjects/ismultiple/README.md

@@ -0,0 +1,45 @@
+## common-multiples
+
+### Instructions
+
+Write a function to check whether a given non-negative number is a multiple of 3 or 7.
+- If the number is a multiple of 3 or 7, return `true`.
+- If the number is not a multiple of 3 or 7, return `false`.
+- If the number is less or equal to 0, return `false`.
+
+### Expected function
+
+```go
+func IsMultiple(number int) bool {
+    // Your code here
+}
+```
+
+### Usage
+
+Here is a possible program to test your function:
+
+```go
+package main
+
+import "fmt"
+
+func main() {
+    fmt.Println(IsMultiple(3))
+    fmt.Println(IsMultiple(7))
+    fmt.Println(IsMultiple(8))
+    fmt.Println(IsMultiple(9))
+    fmt.Println(IsMultiple(-1))
+}
+```
+
+and the output should be:
+
+```console
+$ go run .
+true
+true
+false
+true
+false
+```

subjects/keep-trying-or-giveup/README.md

@@ -2,30 +2,26 @@
 
 ### Instructions
 
-Create a `retry` function, that takes 2 arguments
+Create a `retry` function, that takes 2 arguments:
 
-- a `count` indicates maximum amount of retries
-- an async `callback`, that will be called on every try
+- `count`: indicates maximum number of retries.
+- `callback`: an `async` function that will be invoked for every attempt.
 
-`retry` returns a function that calls and returns value from `callback`
-function passing its arguments and catches errors. If error is caught it
-should return the `callback` function with catch. If number of errors
-exceeds `count` then throw an `Error`.
+`retry` returns a function that invokes the `callback` function. That function passes its arguments to `callback`, and returns the value from `callback`.
 
-> for count of 3, the function will be called at most 4 times:
-> the initial call + 3 retries.
+The function returned by `retry` must `catch` errors from `callback`. After that function has caught `count` errors, it must `throw` an `Error`.
 
-Create a `timeout` function, that takes 2 arguments
+> if `count` is 3, `callback` will be invoked at most 4 times, the initial call plus 3 retries.
 
-- a `delay` indicates maximum wait time
-- an async `callback`, that will be called
+Create function named `timeout`, that takes 2 arguments:
 
-`timeout` returns a function either that calls and returns value from `callback`
-function passing its arguments or returns `Error('timeout')` if `callback` didn't
-resolve before `delay` time has reached.
+- `delay`: indicates maximum wait time.
+- `callback`: an asynchronous function that will be invoked.
+
+`timeout` returns a function that invokes and returns the value from `callback`. The function must pass its arguments to `callback`. If `callback` does not resolve before `delay`, your function returns `Error('timeout')`.
 
 ### Notions
 
-- [nan-academy.github.io/js-training/examples/promise.js](https://nan-academy.github.io/js-training/examples/promises.js)
-- [devdocs.io/dom/settimeout]( https://devdocs.io/dom/settimeout)
-- [devdocs.io/javascript/global_objects/promise/race](https://devdocs.io/javascript/global_objects/promise/race)
+- [Promises](https://nan-academy.github.io/js-training/examples/promises.js)
+- [setTimeout]( https://devdocs.io/dom/settimeout)
+- [Promise.race](https://devdocs.io/javascript/global_objects/promise/race)

subjects/keycodes-symphony/README.md

@@ -2,28 +2,27 @@
 
 ### Instructions
 
-Like an inspired Beethoven who's going to write his Moonlight Sonata, you're about to compose a colourful symphony of letters with your keyboard.
+Like an inspired Beethoven who's about to write his Moonlight Sonata, you're about to compose a colorful symphony of letters with your keyboard.
 
 Write the function `compose`:
-
-- Make it fire every time a key is pressed
-- Create a new `div` with the class `note` when a letter of the lowercase alphabet is pressed, which has a unique background color generated using the `key` of the `event`, and displays the corresponding letter pressed
-- If the pressed key is the `Backspace` one, delete the last note
-- If the pressed key is the `Escape` one, clear all the notes
-
-### Notions
-
-- [Keyboard event](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent): [`keydown`](https://developer.mozilla.org/en-US/docs/Web/API/Document/keydown_event), [`key`](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
+- Make it fire every time a key is pressed.
+- Create a new `div` with the class `note` when a letter of the lowercase alphabet is pressed. It should have a unique background color generated using the `key` of the `event`. It should also displays the corresponding pressed character.
+- When `Backspace` is pressed, delete the last note.
+- When `Escape` is pressed, clear all the notes.
 
 ### Files
 
-You only need to create & submit the JS file `keycodes-symphony.js` ; we're providing you the following file to download (click right and save link) & test locally:
+You only need to create & submit the JS file `keycodes-symphony.js`; we're providing you the following file to download to test locally:
 
 - the HTML file [keycodes-symphony.html](./keycodes-symphony.html) to open in the browser, which includes:
 
-  - the JS script which will allow to run your code
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+  - the JS script which will allow to run your code.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
 ### Expected result
 
 You can see an example of the expected result [here](https://youtu.be/5DdijwBnpAk)
+
+### Notions
+
+- [Keyboard event](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent): [`keydown`](https://developer.mozilla.org/en-US/docs/Web/API/Document/keydown_event), [`key`](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)

subjects/leapyear/README.md

@@ -0,0 +1,41 @@
+## leap-year
+
+### Instructions
+
+Write a function named `LeapYear(int)` that takes a year as a parameter and returns true if the year is a leap year and false otherwise.
+- A leap year is a year divisible by 4, but not by 100.
+- A leap year is also divisible by 400.
+- If the number is not positive, return false
+
+### Expected function
+
+```go
+func LeapYear(year int)bool{
+  // your code here
+}
+```
+### Usage
+
+Here is a possible program to test your function:
+
+```go 
+package main
+
+import "fmt"
+
+func main(){
+  fmt.Println(LeapYear(2020))
+  fmt.Println(LeapYear(2021))
+  fmt.Println(LeapYear(2022))
+  fmt.Println(LeapYear(-10))
+}
+```
+and the output should be:
+
+``` console
+$ go run . | cat -e
+true$
+false$
+false$
+false$
+```

subjects/long-words/README.md

@@ -2,18 +2,15 @@
 
 ### Instructions
 
-Create three functions that take as argument an array each:
+Create three functions, which each accept an array as an argument.
 
-- `longWords` that returns true if every element of the array is a string of at
-  least 5 characters.
+- `longWords`: returns `true` if every element of the array is a `string` with at least 5 characters.
 
-- `oneLongWord` that returns true if at least one element of the array is a
-  string of at least 10 characters.
+- `oneLongWord`: returns `true` if at least one element of the array is a `string` with 10 or more characters.
 
-- `noLongWords` that returns true if there are no elements in the array that are
-  a string with at least 7 characters.
+- `noLongWords`: returns `true` if there are no elements in the array which is a `string` with at least 7 characters.
 
 ### Notions
 
-- [devdocs.io/javascript/global_objects/array/every](https://devdocs.io/javascript/global_objects/array/every)
-- [devdocs.io/javascript/global_objects/array/some](https://devdocs.io/javascript/global_objects/array/some)
+- [Array.prototype.every](https://devdocs.io/javascript/global_objects/array/every)
+- [Array.prototype.some](https://devdocs.io/javascript/global_objects/array/some)

subjects/manipulate-entries/README.md

@@ -2,35 +2,23 @@
 
 ### Instructions
 
-Finish your groceries!!!
+Create 3 functions which work like the `.filter`, `.map` and `.reduce` array methods, but for the **entries** in the grocery cart.
 
-Create 3 functions that works like the `.filter`, `.map` and `.reduce` array method but for the entries of the grocery cart.
+- `filterEntries`: filters using both key and value.
+- `mapEntries`: changes the key, the value or both.
+- `reduceEntries`: reduces the entries.
 
-- `filterEntries` filters using both key and value.
-- `mapEntries` changes either the key or the value or both.
-- `reduceEntries` reduce over entries.
+Create 3 additional functions that use your previously created functions:
 
-Create 3 other functions that use your previously create functions:
+- `totalCalories`: that will return the total calories of a cart.
+- `lowCarbs`: that leaves only those items which are lower than 50grams.
+- `cartTotal`: that will give you the right amount of calories, proteins... and **all the other** items in your grocery cart.
 
-- `totalCalories` that will return the total calories of a cart
-- `lowCarbs` that will leave only items that total carbs are lower than 50grams
-- `cartTotal` that will give you the right amount of calories, proteins, ..., of all items in your grocery cart.
-
-### Clarification
-
-What the functions will take as argument is an object cart which contains the food rations. All the nutrition in the nutritionDB object are measured per 100 grams.
-
-### Notions
-
-- [devdocs.io/javascript/global_objects/array/filter](https://devdocs.io/javascript/global_objects/array/filter)
-- [devdocs.io/javascript/global_objects/array/map](https://devdocs.io/javascript/global_objects/array/map)
-- [devdocs.io/javascript/global_objects/array/reduce](https://devdocs.io/javascript/global_objects/array/reduce)
-- [devdocs.io/javascript/global_objects/object/entries](https://devdocs.io/javascript/global_objects/object/entries)
-- [devdocs.io/javascript/global_objects/object/fromentries](https://devdocs.io/javascript/global_objects/object/fromentries)
+> Think about the shape of `Object.entries()`
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 // small database with nutrition facts, per 100 grams
@@ -46,3 +34,11 @@ const nutritionDB = {
   orange:  { calories: 49,  protein: 0.9,   carbs: 13,    sugar: 9,   fiber: 0.2, fat: 0.1   },
 }
 ```
+
+### Notions
+
+- [filter](https://devdocs.io/javascript/global_objects/array/filter)
+- [map](https://devdocs.io/javascript/global_objects/array/map)
+- [reduce](https://devdocs.io/javascript/global_objects/array/reduce)
+- [entries](https://devdocs.io/javascript/global_objects/object/entries)
+- [fromentries](https://devdocs.io/javascript/global_objects/object/fromentries)

subjects/manipulate-keys/README.md

@@ -2,40 +2,29 @@
 
 ### Instructions
 
-I do not want onions. I want oranges!!!
+I do not want onions. I want oranges.
 
-Create 3 functions that works like the `.filter`, `.map` and `.reduce` array method but for the keys of your grocery cart.
-
-- `filterKeys` filters the name of the items you have.
-- `mapKeys` changes the name of the items you have.
-- `reduceKeys` reducing you grocery cart.
+Create 3 functions that works like the `.filter`, `.map` and `.reduce` array methods, but for the **keys** of your grocery cart. You can see their names and how they work in the examples.
 
 ### Examples
 
 ```js
 const nutrients = { carbohydrates: 12, protein: 20, fat: 5 }
+
 console.log(filterKeys(nutrients, (key) => /protein/.test(key)))
-// output :
-// { protein: 20 }
+// output: { protein: 20 }
+
 console.log(mapKeys(nutrients, (k) => `-${k}`))
-// output :
-// { -carbohydrates: 12, -protein: 20, -fat: 5 }
+// output: { -carbohydrates: 12, -protein: 20, -fat: 5 }
+
 console.log(reduceKeys(nutrients, (acc, cr) =>acc.concat(', ', cr)))
-// output :
-// carbohydrates, protein, fat
+// output: carbohydrates, protein, fat
 ```
 
-### Notions
-
-- [devdocs.io/javascript/global_objects/array/filter](https://devdocs.io/javascript/global_objects/array/filter)
-- [devdocs.io/javascript/global_objects/array/map](https://devdocs.io/javascript/global_objects/array/map)
-- [devdocs.io/javascript/global_objects/array/reduce](https://devdocs.io/javascript/global_objects/array/reduce)
-- [devdocs.io/javascript/global_objects/object/entries](https://devdocs.io/javascript/global_objects/object/entries)
-- [devdocs.io/javascript/global_objects/object/fromentries](https://devdocs.io/javascript/global_objects/object/fromentries)
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 // small database with nutrition facts, per 100 grams
@@ -51,3 +40,11 @@ const nutritionDB = {
   orange:  { calories: 49,  protein: 0.9,   carbs: 13,    sugar: 12,  fiber: 0.2, fat: 0.1   },
 }
 ```
+
+### Notions
+
+- [filter](https://devdocs.io/javascript/global_objects/array/filter)
+- [map](https://devdocs.io/javascript/global_objects/array/map)
+- [reduce](https://devdocs.io/javascript/global_objects/array/reduce)
+- [entries](https://devdocs.io/javascript/global_objects/object/entries)
+- [fromEntries](https://devdocs.io/javascript/global_objects/object/fromentries)

subjects/manipulate-values/README.md

@@ -2,48 +2,32 @@
 
 ### Instructions
 
-Go buy groceries!!!
+Let's buy groceries.
 
-You have a grocery cart with some items you need.
-The items will have a `key` being the name and a `value` that is the amount in grams.
+You have a grocery cart with some items you need. The item's name is the `key`, and the `value` will represent nutrition facts per 100 grams.
 
-Create 3 functions that works like the `.filter`, `.map` and `.reduce` array method but for the values of your grocery cart.
-
-- `filterValues` filters the values of your grocery cart.
-- `mapValues` changes the values of your grocery cart.
-
-For the above function the callback function should accepts only the element in the arguments, this being the current element being processed.
-
-- `reduceValues` that will reduce your grocery cart. The callback function should accepts only the **accumulated value** and the **current value**.
+Create 3 functions that work like the `.filter`, `.map` and `.reduce` array methods, for the values in your grocery cart object. You can see their function names and how they work in the examples.
 
 ### Examples
 
 ```js
 const nutrients = { carbohydrates: 12, protein: 20, fat: 5 }
+
 console.log(filterValues(nutrients, (nutrient) => nutrient <= 12))
-// output :
-// { carbohydrates: 12, fat: 5 }
+// output: { carbohydrates: 12, fat: 5 }
+
 console.log(mapValues(nutrients, (v) => v+1))
-// output :
-// { carbohydrates: 13, protein: 21, fat: 6 }
+// output: { carbohydrates: 13, protein: 21, fat: 6 }
+
 console.log(reduceValues(nutrients, (acc, cr) => acc + cr))
-// output :
-// 37
+// output: 37
 ```
 
 You will have a small database to help you with the groceries.
 
-### Notions
-
-- [devdocs.io/javascript/global_objects/array/filter](https://devdocs.io/javascript/global_objects/array/filter)
-- [devdocs.io/javascript/global_objects/array/map](https://devdocs.io/javascript/global_objects/array/map)
-- [devdocs.io/javascript/global_objects/array/reduce](https://devdocs.io/javascript/global_objects/array/reduce)
-- [devdocs.io/javascript/global_objects/object/entries](https://devdocs.io/javascript/global_objects/object/entries)
-- [devdocs.io/javascript/global_objects/object/fromentries](https://devdocs.io/javascript/global_objects/object/fromentries)
-
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submitted.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 // small database with nutrition facts, per 100 grams
@@ -60,3 +44,11 @@ const nutritionDB = {
     orange:  { calories: 49,  protein: 0.9,   carbs: 13,    sugar: 9,   fiber: 0.2, fat: 0.1   },
   }
 ```
+
+### Notions
+
+- [filter](https://devdocs.io/javascript/global_objects/array/filter)
+- [map](https://devdocs.io/javascript/global_objects/array/map)
+- [reduce](https://devdocs.io/javascript/global_objects/array/reduce)
+- [entries](https://devdocs.io/javascript/global_objects/object/entries)
+- [fromEntries](https://devdocs.io/javascript/global_objects/object/fromentries)

subjects/mapper/README.md

@@ -2,23 +2,21 @@
 
 ### Instructions
 
-- Create a `map` function that takes an array as first argument, a function as second,
-  and that works like the method .map
+- Create a `map` function that takes an array as the first argument, a function as second, and that works like the method `.map`
 
-- Create a `flatMap` function that takes an array as first argument, a function as second,
-  and that works like the method .flatMap
-
-### Notions
-
-- [devdocs.io/javascript/global_objects/array/map](https://devdocs.io/javascript/global_objects/array/map)
-- [devdocs.io/javascript/global_objects/array/flatmap](https://devdocs.io/javascript/global_objects/array/flatmap)
+- Create a `flatMap` function that takes an array as the first argument, a function as second, and that works like the method `.flatMap`
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 Array.prototype.map = undefined
 Array.prototype.flatMap = undefined
 Array.prototype.flat = undefined
 ```
+
+### Notions
+
+- [devdocs.io/javascript/global_objects/array/map](https://devdocs.io/javascript/global_objects/array/map)
+- [devdocs.io/javascript/global_objects/array/flatmap](https://devdocs.io/javascript/global_objects/array/flatmap)

subjects/mouse-trap/README.md

@@ -2,34 +2,39 @@
 
 ### Instructions
 
-Develop a trap to capture the elements when the mouse is getting too close to the center of the page!
+Develop a trap to capture the elements when the mouse is getting too close to the center of the page.
 
-- Create a function `createCircle`: make it fire on every click on the page, and create a `div` at the position of the mouse on the screen, setting its `background` to `white` and its class to `circle`
+Create the following functions:
+- `createCircle`: make it fire on every click on the page, and create a `div` at the position of the mouse on the screen, setting its `background` to `white` and its class to `circle`.
 
-- Create a function `moveCircle`: make it fire when the mouse moves, and get the last circle created and makes it move along with the mouse
+- `moveCircle`: make it fire when the mouse moves, and get the last circle created and makes it move along with the mouse.
 
-- Create a function `setBox` which sets a box with the class `box` in the center of the page ; when a circle is inside that box, it has to be purple (use the CSS global variable `var(--purple)` as `background`) ; once a circle enters the box, it is trapped inside and cannot go out of it anymore.
+- `setBox`: which creates a box with the class `box` in the center of the page. When a circle is inside that box, it has to be purple (use the CSS global variable `var(--purple)` as its `background`). Once a circle enters the box, it is trapped inside and cannot escape.
 
-> Hint: Be careful, a circle cannot overlap the box which has walls of `1px`, it has to be trapped **strictly** inside.
-
-### Notions
-
-- [`addEventListener()`](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener): `click`, `mousemove`
-- [`removeEventListener()`](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener)
-- [Mouse event](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent): [`click`](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event), [`mousemove`](https://developer.mozilla.org/en-US/docs/Web/API/Element/mousemove_event) / [`clientX`](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientX), [`clientY`](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientY)
-- [`getBoundingClientRect()`](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect)
+> Hint: Be careful, a circle cannot overlap the box which has walls of `1px`. It has to be trapped **strictly** inside.
 
 ### Provided files
 
 ### Files
 
-You only need to create & submit the JS file `mouse-trap.js` ; we're providing you the following file to download (click right and save link) & test locally:
+You only need to create & submit the JS file `mouse-trap.js`; we're providing you the following file to download and test locally:
 
 - the HTML file [mouse-trap.html](./mouse-trap.html) to open in the browser, which includes:
 
-  - the JS script which will allow to run your code
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+  - the JS script which will enable you to run your code.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
 ### Expected result
 
 You can see an example of the expected result [here](https://youtu.be/qF843P-V2Yw)
+
+### Notions
+
+- [addEventListener](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)
+- [removeEventListener](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener)
+- [Mouse event](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
+- [click](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event)
+- [mousemove](https://developer.mozilla.org/en-US/docs/Web/API/Element/mousemove_event)
+- [clientX](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientX)
+- [clientY](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientY)
+- [getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect)

subjects/neuron/README.md

@@ -2,8 +2,7 @@
 
 ### Instructions
 
-Create a function called `neuron` that allows your AI/bot to learn how to data shape a given
-dataset into an object so that it can better navigate the data.
+Create a function named `neuron`, that enables your AI/bot to learn to mutate data into a more usable shape. You can see how it works from the example.
 
 ### Example
 

subjects/paramrange/README.md

@@ -0,0 +1,20 @@
+## param-range
+
+### instructions
+
+Write a program that takes a number in the arguments and prints the max and min.
+- If the number of arguments is less than 2 print (`'\n'`)
+- If one of the arguments is not a number, print (`"Error\n"`)
+- The output should be space-separated and (`'\n'`) at the end.
+
+### Usage
+```console
+$ go run . | cat -e
+$
+$ go run . 1 2 3 4 5 6 7 8 9 | cat -e
+1 9$
+$ go run . "-1" "1" | cat -e
+-1 1$
+$ go run . 1 a 2 3 4 5 6 7 8 9 | cat -e
+Error$
+```

subjects/pick-and-click/README.md

@@ -2,43 +2,47 @@
 
 ### Instructions
 
-Today, you're gonna create your own color picker.
+Today, you're going to create your own color picker.
 
-Write the function `pick` which turns the screen into a `hsl` color picker, varying the `hue` and `luminosity` of according to the position of the mouse, which:
+Write the function `pick` which turns the screen into a `hsl` color picker. It will vary the `hue` and `luminosity` according to the position of the mouse.
 
-- changes the `background` color of the `body`, so the `hsl` value is different on each mouse position on the screen:
-  - on the axis X, the hue value has to vary between 0 and 360
-  - on the axis Y, the luminosity value has to vary between 0 and 100
-- displays those 3 values using the `text` class:
-  - the full `hsl` value in a `div` with the class `hsl` in the middle of the screen
-  - the `hue` value in a `div` with the class `hue` in the top right corner of the screen
-  - the `luminosity` value in a `div` with the class `luminosity` in the bottom left corner of the screen
-- copies that value in the clipboard on click
-- displays two SVG lines, with respective ids `axisX` and `axisY`, following the cursor like so:
-  - the axisX has to set the attributes `x1` and `x2` to the mouse X position
-  - the axisY has to set the attributes `y1` and `y2` to the mouse Y position
+The `background` color of the `body` will change based on the position of the mouse on the screen.
+  - The X axis will vary the hue value between 0 and 360.
+  - The Y axis will vary the luminosity value between 0 and 100.
 
-> Here is how a hsl value is formatted: `hsl(45, 50%, 35%)`
+You'll need to display these three values:
+- The full `hsl` value in a `div`, which has the class `hsl` in the middle of the screen.
+- The `hue` value in a `div` with the class `hue` in the top right corner of the screen.
+- The `luminosity` value will be displayed in the bottom left corner of the screen, in a `div` with the class `luminosity`.
 
-> Use `Math.round()` to round the values
+When the mouse is clicked, the value of the `hsl` will need to copied to the clipboard.
 
-### Notions
+Two SVG lines with ids `axisX` and `axisY` will need to follow the cursor, like really long cross hairs.
+  - the `axisX` attributes `x1` and `x2` need to be set to the X position of the cursor.
+  - the `axisY` attributes `y1` and `y2` need to be set to the Y position of the cursor.
 
-- [Copy event](https://developer.mozilla.org/en-US/docs/Web/API/Element/copy_event)
-- [Mouse move event](https://developer.mozilla.org/en-US/docs/Web/API/Element/mousemove_event)
-- [SVG](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/svg): [`createElementNS`](https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS), [`setAttribute`](https://developer.mozilla.org/en-US/docs/Web/API/Element/setAttribute)
-- Take a look at the [HSL section](https://developer.mozilla.org/en-US/docs/Web/HTML/Applying_color)
+> The formatting of a `hsl` value: `hsl(45, 50%, 35%)`.
+
+> Use `Math.round()` to round the values.
 
 ### Files
 
-You only need to create & submit the JS file `pick-and-click.js` ; we're providing you the following file to download (click right and save link) & test locally:
+You only need to create & submit the JS file `pick-and-click.js`; we're providing you the following file to download and test locally:
 
 - the HTML file [pick-and-click.html](./pick-and-click.html) to open in the browser, which includes:
 
-  - the JS script which will allow to run your code
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+  - the JS script which will enable you to run your code.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
 ### Expected result
 
-You can see an example of the expected result:
-[![video](https://img.youtube.com/vi/eE4eE9_eKZI/0.jpg)](https://www.youtube.com/watch?v=eE4eE9_eKZI)
+You can see an example of the expected result [here](https://www.youtube.com/watch?v=eE4eE9_eKZI)
+
+### Notions
+
+- [Copy event](https://developer.mozilla.org/en-US/docs/Web/API/Element/copy_event)
+- [Mouse move event](https://developer.mozilla.org/en-US/docs/Web/API/Element/mousemove_event)
+- [SVG](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/svg)
+- [createElementNS](https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS)
+- [setAttribute](https://developer.mozilla.org/en-US/docs/Web/API/Element/setAttribute)
+- Take a look at the [HSL section](https://developer.mozilla.org/en-US/docs/Web/HTML/Applying_color)

subjects/pick-omit/README.md

@@ -2,14 +2,12 @@
 
 ### Instructions
 
-Create a `pick` function that takes an object and a string or array of strings.
-This function returns a new object that contains only the key/value pairs, whose key matches with the string or a string in the array, from the object passed as an argument.
-
-Create a `omit` function that takes an object and a string or array of strings.
-This function returns a new object that contains only the key/value pairs, whose key doesn't match with the string or a single string in the array, from the object passed as an argument.
+Create two functions which taken an object and a string or array of strings. They should return a new object which:
+- `pick`: contains only those keys which appear in the string or array of strings.
+- `omit`: contains only those keys which do not match the string, or do not appear in the array of strings.
 
 > Those functions are pure and must not modify the given object
 
 ### Notions
 
-- [devdocs.io/javascript/global_objects/object](https://devdocs.io/javascript/global_objects/object)
+- [object](https://devdocs.io/javascript/global_objects/object)

subjects/pimp-my-style/README.md

@@ -8,18 +8,22 @@ Check out that button on the HTML page:
 <button class="button">pimp my style</div>
 ```
 
-For now, it's only a lonely, basic and sad element ; let's pimp it up!
+For now, it's only a lonely, basic and sad element. let's pimp it up.
 
 On each click on the page, a function `pimp` is triggered.
 Write the body of that function so that the button's class is altered:
 
-- Add in order the next class of the `styles` array provided in the data file below
-- When the end of the array is reached, remove backwards each class
-- Toggle the class 'unpimp' when removing classes
+- From the data file provided, add each of the `styles` array elements as classes, in order.
+- When the end of the array is reached, remove the classes in a FIFO fashion.
+- While removing classes, toggle the `unpimp` class on. And toggle it off again while adding classes.
+
 
-```
 Example for a `styles` array with only 3 classes:
+```js
+["one", "two", "three"]
+```
 
+```
 Page load --> <button class="button"></div>
 
 ...adding
@@ -35,21 +39,20 @@ Click 5 --> <button class="button one unpimp"></div>
 Click 6 --> <button class="button"></div>
 ```
 
-### Notions
-
-- [`classList`](https://developer.mozilla.org/en-US/docs/Web/API/Element/classList): `add()`, `remove()`, `toggle()`
-
 ### Files
 
-You only need to create & submit the JS file `pimp-my-style.js` ; we're providing you the following files to download (click right and save link) & test locally:
+You only need to create & submit the JS file `pimp-my-style.js`. Ee're providing you the following files to download and test locally.:
 
 - the HTML file [pimp-my-style.html](./pimp-my-style.html) to open in the browser, which includes:
 
-  - the JS script running some code, and which will also allow to run yours
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
-
-- the data file [pimp-my-style.data.js](./pimp-my-style.data.js) from which you can import `styles`
+  - the JS script running some code, and which will enable you to run yours.
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
+- the data file [pimp-my-style.data.js](./pimp-my-style.data.js) from which you can import `styles`.
 
 ### Expected result
 
 You can see an example of the expected result [here](https://youtu.be/VIRf3TBDTN4)
+
+### Notions
+
+- [classList](https://developer.mozilla.org/en-US/docs/Web/API/Element/classList): `add()`, `remove()`, `toggle()`

subjects/printascii/README.md

@@ -0,0 +1,23 @@
+## print-ascii
+
+### Instructions
+
+Write a program that prints the ASCII value of a letter passed in the command line
+- If the argument is not a letter nothing will be printed
+- if the number of arguments is not 1 then nothing will be printed
+
+### Usage
+
+```console
+$ go run .
+$ go run . a
+97
+$ go run . 'A'
+65
+$ go run . 'z'
+122
+$ go run . Z
+90
+$ go run . 1
+$ go run . "Hello" "Word"
+```

subjects/pronoun/README.md

@@ -2,10 +2,19 @@
 
 ### Instructions
 
-Create a function called `pronoun` that has a string as parameter. This function returns an object
-that will have all the personal pronouns, present in the string, as keys. Each key will have a sub object with the
-first word after each of the personal pronouns found in the string.
-Also, a property `count` must be added, to the sub object, with the amount of occurrences of the pronoun.
+Create a function named `pronoun` that accepts a string parameter.
+This function returns an object that will have all the personal pronouns, present in the string, as keys. Each key will have a sub object with the first word after each of the personal pronouns found in the string.
+
+You must also a `count` property to the sub object, with the amount of occurrences of the pronoun.
+
+Pronouns:
+- i
+- you
+- he
+- she
+- it
+- they
+- we
 
 #### Example
 

subjects/quantifiers/README.md

@@ -2,26 +2,22 @@
 
 ### Instructions
 
-Create three functions that receive an array and a function each:
-
-- `every` that returns true if every element of the array respects the
-  condition of the received function and false otherwise.
-- `some` that returns true if at least one element of the array respects the
-  condition of the received function and false otherwise.
-- `none` that returns true if none of the elements of the array respects the
-  condition of the received function and false otherwise.
+Create these functions which receive an array and a function each. Each element will return `true` if
+- `every`: every element in the array respects the condition of the function.
+- `some`: that returns `true` if at least one element in the array respects the condition of the function.
+- `none`: that returns `true` if **none** of the elements in the array respects the condition of the function.
 
 The use of `[].every` and `[].some` is forbidden for this exercise.
 
-### Notions
-
-- [devdocs.io/javascript/global_objects/array/some](https://devdocs.io/javascript/global_objects/array/some)
-- [devdocs.io/javascript/global_objects/array/every](https://devdocs.io/javascript/global_objects/array/every)
-
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 Array.prototype.some = Array.prototype.every = undefined
 ```
+
+### Notions
+
+- [devdocs.io/javascript/global_objects/array/some](https://devdocs.io/javascript/global_objects/array/some)
+- [devdocs.io/javascript/global_objects/array/every](https://devdocs.io/javascript/global_objects/array/every)

subjects/race/README.md

@@ -2,22 +2,20 @@
 
 ### Instructions
 
-Create a function `race` that works like `Promise.race`
+Create two functions:
+- `race`: that works like `Promise.race`.
+- `some`: that takes an `array` of promises or values, and `count` number. It should return the first `count` resolved values. Empty arrays or a `count` of 0 return a promise resolving to `undefined`.
 
-Create a function `some` that takes an `array` of promises or values
-and `N` number. It should return the first `N` resolved values.
-
-> Empty array or a count of 0 return a promise resolving to `undefined`
-
-### Notions
-
-- [nan-academy.github.io/js-training/examples/promise](https://nan-academy.github.io/js-training/examples/promise.js)
-- [devdocs.io/javascript/global_objects/promise/race](https://devdocs.io/javascript/global_objects/promise/race)
 
 ### Code provided
 
-> all code provided will be added to your solution and doesn't need to be submited.
+> The provided code will be added to your solution, and does not need to be submitted.
 
 ```js
 Promise.race = undefined
 ```
+
+### Notions
+
+- [Promise](https://nan-academy.github.io/js-training/examples/promise.js)
+- [Promise.race](https://devdocs.io/javascript/global_objects/promise/race)

subjects/ref_cell/README.md

@@ -18,31 +18,35 @@ fn error(&self, msg: &str);
 ```
 
 Implement the `Tracker` structure with the following fields:
+
 - `logger`: a reference to `Logger`.
 - `value`: the count of how many times the value was referenced. It should not exceed `max`.
 - `max`: the max count of references.
 
 Add the following associated functions to `Tracker`:
+
 - `new`: that initializes the structure.
 - `set_value`: that sets the `value`. It should compare the number of references to `value` and `max` to work out the percentage used. It should write to the following traits if it exceeds the specified usage percentage:
   - percentage >= 100%: `"Error: you are over your quota!"` should be written to `error`.
   - percentage >= 70% and percentage < 100%: `"Warning: you have used up over X% of your quota! Proceeds with precaution"` should be written to `warning`, where `X` should be replaced with the calculated percentage.
-- `peek`: that will take a peek at how much usage the variable already has. It should write `"Info: you are using up too X% of your quote"` to the `info` trait function. `X` should be replaced with the calculated percentage.
+- `peek`: that will take a peek at how much usage the variable already has. It should write `"Info: you are using up to X% of your quota"` to the `info` trait function. `X` should be replaced with the calculated percentage.
 
 ### Second part (lib.rs)
 
 Now that you've created `messenger`, you can now create the following:
 
 Create the `Worker` structure with the following fields:
+
 - `track_value`: which is the value that will be tracked by the tracker.
 - `mapped_messages`: that will store the latest messages from the `Logger` trait functions. This will be a HashMap. The key will represent the type of message (`info`, `error` or `warning`), and the value will be the actual message.
 - `all_messages`: that will be a vector of **all** messages sent.
 
 Create the following associated functions for `Worker`:
+
 - `new`: that initializes a `Worker` structure.
 - `Logger`: to use the trait `Logger`, you must implement it for the `Worker` structure. Each function (`warning`, `error` and `info`) must insert the message to the respective field of the `Worker` structure.
 
-You must use **interior mutability**, this means it must be possible to mutate data, even when there are immutable references to that data. Consequently, the user will not need to use the keyword `mut`. *tip:* RefCell.
+You must use **interior mutability**, this means it must be possible to mutate data, even when there are immutable references to that data. Consequently, the user will not need to use the keyword `mut`. _tip:_ RefCell.
 
 ### Usage
 
@@ -96,11 +100,11 @@ And its output:
 
 ```console
 $ cargo run
-("Info", "you are using up too 40% of your quote")
+("Info", "you are using up to 40% of your quota")
 ("Warning", "you have used up over 90% of your quota! Proceeds with precaution")
 ("Error", "you are over your quota!")
 [
-  "Info: you are using up too 40% of your quote",
+  "Info: you are using up to 40% of your quota",
   "Warning: you have used up over 80% of your quota! Proceeds with precaution",
   "Warning: you have used up over 90% of your quota! Proceeds with precaution",
   "Error: you are over your quota!"

subjects/replica/README.md

@@ -2,11 +2,10 @@
 
 ### Instructions
 
-Create a function called `replica` that allows you to deep assign the values of all properties from one or more
-objects to a target object.
+Create a function named `replica` that allows you to deep assign the values of all properties from one or more objects to a target object.
 
-Attention with the shallow copies.
+> Watch out for shallow copies.
 
 ### Notions
 
-- [nan-academy.github.io/js-training/examples/data-structures](https://nan-academy.github.io/js-training/examples/data-structures.js)
+- [data-structures](https://nan-academy.github.io/js-training/examples/data-structures.js)

subjects/roman_numbers_iter/README.md

@@ -21,7 +21,7 @@ impl Iterator for RomanNumber {}
 Here is a program to test your function.
 
 ```rust
-use roman_numbers::RomanNumber;
+use roman_numbers_iterator::RomanNumber;
 
 fn main() {
 	let mut number = RomanNumber::from(15);

subjects/rotargn/README.md

@@ -0,0 +1,27 @@
+## rot-arg-n
+
+### Instructions
+
+Write a program that takes arguments from the command line and rotates them by the number in the first argument.
+- If the number of arguments is less than 3 print (`'\n'`)
+- If the first argument is not a number, the program should print `"Error\n"`
+- If the first argument is negative, the program should print `"Error\n"`
+- If the first argument is zero, the program should print the original arguments
+- Prints the rotated arguments with a space between each argument and a newline at the end.
+
+### Usage
+
+```console
+$ go run . | cat -e
+$
+$ go run . 1 2 3 4 5 | cat -e
+3 4 5 2$
+$ go run . 2 "Hello" "World" | cat -e
+Hello World$
+$ go run . -1 2 3 4 5 | cat -e
+Error$
+$ go run . 0 2 3 4 5 | cat -e
+2 3 4 5$
+$ go run . 3 "Hello" "World" | cat -e
+World Hello$
+```

subjects/sales/README.md

@@ -91,7 +91,7 @@ And its output:
 ```console
 $ cargo run
 Store { products: [("product A", 1.23), ("product B", 23.1), ("product C", 3.12)] }
-[1.17, 2.98, 22.07]
+[1.17, 2.98, 22.06]
 Cart { items: [("product A", 1.23), ("product B", 23.1), ("product C", 3.12)], receipt: [1.17, 2.98, 22.07] }
 $
 ```

subjects/series/README.md

@@ -2,9 +2,8 @@
 
 ### Instructions
 
-Create a function `series` that takes an array of async functions.
-It must execute them in series and return the results in order.
+Create a function named `series` that takes an array of `async` functions. It must execute them in series and return the results in order.
 
 ### Notions
 
-- [nan-academy.github.io/js-training/examples/promise](https://nan-academy.github.io/js-training/examples/promise.js)
+- [Promise](https://nan-academy.github.io/js-training/examples/promise.js)

subjects/sortable/README.md

@@ -2,43 +2,34 @@
 
 ### Instructions
 
-You are a villain and your dream is to end with those annoying, yoga pants,
-weird masks wearing **superheroes**. You never understood why are some of them
-considered superheroes just because they are rich. Others annoy you with their
-philosophical speeches. And of course that something tragic has had to happen
-to them for the people to feel sorry for them. \
-Anyway, we've found _confidential_ information about those superheroes.
+You are a villain and your dream is to get rid of those annoying, yoga-pant-wearing, weird masked **superheroes**.
+You never understood why some of them are considered to be superheroes, just because they are rich. Others annoy you with their philosophical speeches.
 
-> Your task for the moment is to build a web page in order to organize all the
-> data from those smartypants.
-> This information can be found here: [all.json](https://rawcdn.githack.com/akabab/superhero-api/0.2.0/api/all.json).
+We've found _confidential_ information about those superheroes.
 
-Note that since this mission is using *critical* data, you are not allowed to
-rely on any frameworks or libraries, you have to be the author of every bit
-of code.
+**Your task** is to build a web page to organize all the data about those smartypants. All that data can be found [here](https://rawcdn.githack.com/akabab/superhero-api/0.2.0/api/all.json) in `all.json`.
 
-#### Fetching the data
+You must write all of the code from scratch. You are not allowed to rely on any frameworks or libraries like React, Vue, Svelte etc.
 
-In order to get the information out of the API you should use `fetch`.
-In JS when you use `fetch` it always returns a `Promise` we will look
-deeper into those later on, for now just refer to the code example below:
+#### Fetching the data
+In order to get the information, you should use `fetch`.
+When you use `fetch` in JS, it always returns a `Promise`. We will look more deeply into that later on. For now, tak a look at this:
 
 ```js
+// This function is called only after the data has been fetched, and parsed.
 const loadData = heroes => {
-  console.log(heroes) // write your code using the data in a function
-  // note that you can not access heroes before this function is called.
+  console.log(heroes)
 }
 
-// Request the file fetch, it will download it in your browser cache
+// Request the file with fetch, the data will downloaded to your browser cache.
 fetch('https://rawcdn.githack.com/akabab/superhero-api/0.2.0/api/all.json')
   .then((response) => response.json()) // parse the response from JSON
-  .then(loadData) // .then will call the function with the JSON value
+  .then(loadData) // .then will call the `loadData` function with the JSON value.
 ```
 
 #### Display
 
-Not every field should be presented in a `<table>` element,
-the necessary data will be:
+Not all the information is valuable at a glance, so we will only show some of the fields in a `<table>` element. The necessary data will be:
 
 - Icon (`.images.xs`, should be displayed as images and not as a string)
 - Name (`.name`)
@@ -51,46 +42,38 @@ the necessary data will be:
 - Place Of Birth (`.biography.placeOfBirth`)
 - Alignement (`.biography.alignment`)
 
-The information must be displayed in multiple pages. \
-A `<select>` input is used to chose from `10`, `20`,`50`, `100` or `all results`.
+The information must be displayed in multiple pages. Use a `<select>` input to chose the page size from `10`, `20`,`50`, `100` or `all results`.
 
-> The default page size selected option must be `20`
+The default page size selected option must be `20`.
 
 #### Search
 
-It must be possible to filter information by searching the name as a string
-_(ex: superheroes that contain **man** in their name)._
+It must be possible to filter information by searching the name as a string. For example, searching _"man"_ should find all superheros with `"man"` in their name.
 
-- The search should be interactive, in other words, the results should be
-  displaying as you write, not needing a button for you to click.
+The search should be interactive. In other words, the results should be filtered after every keystroke. So we don't need a "search" button.
 
 #### Sort
 
-It must be possible to sort by any columns of the table
-_(either alphabetically or numerically)._
-
-- Initially all rows should be sorted by the column `name` by `ascending` order
-- First click will order the column by `ascending` value
-- Consecutive clicks will toggle between `ascending` and `descending` order
-- Note that, for example, the column `weight` will be composed of strings, so
-  the correct order would be `['78 kg', '100 kg']` instead of the other way
-  around
-- Missing values should always be sorted last.
-
-> As you know, when you are against heroes, **speed** is critical, every operations on
-> the database should be very fast and not slow down the browser
-
-### Optional
-
-Any additional features will be critical to your success, everything count:
-better filtering, better design, more details... here a few:
-
-- Allow to specify the field you search on and search on any field.
-- Custom search operators like allowing `include` / `exclude` or `fuzzy` string
-  matching and `equal` / `not equal` / `greater than` / `lesser than` for numbers
-  (this includes weight and height).
-- Detail view when clicking on a hero that show all the details and large image.
-- A slick design spend some time on the CSS, make it look great, have fun with it.
-- The URL must be updated with the search, so if you copy and paste this url it
-  will present the same result(s). If you have implemented the detail view,
-  which hero is detail view is open should be also be saved in the URL.
+It will be valuable to sort the information in the table by any of its columns. Results should be sortable alphabetically or numerically.
+
+- Initially all rows should be sorted by the column `name` by `ascending` order.
+- The first click on a column heading will sort the table by the data in that column in `ascending` order.
+- Consecutive clicks on a column heading will toggle between `ascending` and `descending`.
+- Some of the columns are composed of strings, but represent numerical values. For example, when the `weight` column is sorted in ascending order, then `"78 kg"` must be displayed before `"100 kg"`.
+- Missing values should **always** be sorted last, irrespective of `ascending` or `descending`.
+
+> When dealing with heroes, **speed** is critical. All operations must be performed quickly, without slowing the browser down.
+
+### Bonus
+
+Additional features will be critical to your success. Here's a few which will give you a bigger boost:
+
+- Specify the field that the search applies to.
+- Custom search operators
+  - `include`
+  - `exclude`
+  - `fuzzy`
+  - `equal`, `not equal`, `greater than` and  `lesser than` for numbers (including weight and height).
+- Detail view. Clicking a hero from the list will show all the details and large image.
+- A slick design. Spend some time improving the look and feel by playing around with CSS. Have fun with it.
+- Modify the URL with the search term, so that if you copy and paste the URL in a different tab, it will display the same column filters. If you have implemented detail view, the state of which hero is displayed should also form part of the URL.

subjects/sortable/audit/README.md

@@ -1,57 +1,57 @@
-#### Functionals
+#### Functional
 
-###### Does the data appear in a table element?
+###### Does the data appear in a `<table>` element?
 
-###### Does the table presents just the requested data (icon, name, full name, powerstats, race, gender, height, weight, place of birth, alignment), instead of all of it?
+###### Does the table present just the required data (icon, name, full name, power stats, race, gender, height, weight, place of birth, alignment), instead of all of it?
 
-###### Are there different pages that display different information?
-
-###### Can you change the amount of results displayed between **10**, **20**, **50**, **100** or **all results**?
+###### Has client-side pagination been implemented? Are there different pages that display different information?
 
 ###### Does the table initially displays 20 results?
 
-###### Are the results initially sorted by the column **name** by **ascending** order?
+###### Can you change the page size to one of **10**, **20**, **50**, **100** or **all results**?
+
+###### Are the results initially sorted by the **name** column in **ascending** order?
 
 ###### Are all columns of the table clickable in order to sort the results?
 
 ##### Try to click once to sort the table by weight.
 
-###### Did the results became sorted numerically by weight in **ascending** order? (be aware that cases like [75 kg, 100kg] should be in that order and not the other way around)
+###### Was the table sorted numerically by weight in **ascending** order? (be aware that cases like [75 kg, 100kg] should be in that order and not the other way around)
 
-##### Try to click twice to sort the by place of birth.
+##### Try to click twice to sort the table by place of birth.
 
-###### Did the results became sorted alphabetically by place of birth in **descending** order?
+###### Were the results sorted alphabetically by place of birth in **descending** order?
 
 ##### Try to click several times on a column and observe its behavior.
 
-###### Did the results became sorted in **ascending** and **descending** order, alternately?
-
-##### Try to search for `Superman`.
+###### Did the sort order toggle between **ascending** and **descending** order?
 
 ###### Are the missing values always shown last?
 
-###### As you type, does the results on the table change?
-
 ##### Write only `Cat` on the search field.
 
-###### Does Catwoman appear on the results?
+###### As you type, do the results on the table change?
+
+###### Does Catwoman appear in the results?
 
 ###### Does the project contains the use of `fetch`?
 
-###### Confirm that no frameworks or librairies where used
+##### Check the project to ensure that it does not use any libraries of frameworks (React, Vue, Svelte etc).
+
+###### Is the project free of any frameworks or librairies?
 
 #### Bonus
 
 ###### +Can you search for any fields apart from the name?
 
-###### +Can you do a search with search operators (include/exclude for strings and equal/not equal/greater than/lesser than)?
+###### +Can you do a search with search these search operators: include/exclude for strings and equal/not equal/greater than/less than)?
 
-###### +If you click on a hero, does the site displays the details and a large image of it?
+###### +If you click on a hero, does the site display the details and a large image of it?
 
-###### +Does the URL changes when you make a search?
+###### +Does the URL change when you make a search?
 
-###### +After making a search and the URL changes, if you copy and paste it in a different window, are the results displayed in the table the same as the ones from the search?
+###### +After making a search and the URL changes, if you copy and paste it to a different tab, are the results displayed in the table the same as the ones from the previous tab?
 
-###### +Does the project runs quickly and effectively? (Favoring recursive, no unnecessary data requests, etc)
+###### +Does the project run quickly and effectively? (Favoring recursive, no unnecessary data requests, etc)?
 
 ###### +Does the code obey the [good practices](https://public.01-edu.org/subjects/good-practices/README.md)?

subjects/sweet-curry/README.md

@@ -2,13 +2,11 @@
 
 ### Instructions
 
-Create the following functions with the "currying" process:
+Create the following functions with the "currying" process. Those functions should accept only one argument each.
 
-- mult2 that multiplies two numbers.
-- add3 that adds three numbers.
-- sub4 that subtracts four numbers.
-
-Please note that those functions can only have one argument each.
+- `mult2`: that multiplies two numbers.
+- `add3`: that adds three numbers.
+- `sub4`: that subtracts four numbers.
 
 ### Notions
 

subjects/throttle/README.md

@@ -2,14 +2,13 @@
 
 ### Instructions
 
-Create two functions that will work like `_.throttle` from lodash
+Create two functions that will work like `_.throttle` from lodash.
 
-- `throttle`, this function doesn't need to take care of the options
-- `opThrottle`, this function will take care of
-  the `trailing` and `leading` options
+- `throttle`: don't worry about the options.
+- `opThrottle`: implement the `trailing` and `leading` options.
 
 ### Notions
 
-- [lodash.com/docs/4.17.15#throttle](https://lodash.com/docs/4.17.15#throttle)
-- [https://css-tricks.com/debouncing-throttling-explained-examples/#throttle](https://css-tricks.com/debouncing-throttling-explained-examples/#throttle)
-- [https://stackoverflow.com/questions/24079736/confused-about-the-maxwait-option-for-lodashs-debounce-method](https://stackoverflow.com/questions/24079736/confused-about-the-maxwait-option-for-lodashs-debounce-method)
+- [lodash throttle](https://lodash.com/docs/4.17.15#throttle)
+- [css-tricks throttle](https://css-tricks.com/debouncing-throttling-explained-examples/#throttle)
+- [stackoverflow about lodash debounce](https://stackoverflow.com/questions/24079736/confused-about-the-maxwait-option-for-lodashs-debounce-method)

subjects/tron/audit/README.md

@@ -43,4 +43,4 @@ Serving HTTP on :: port 8000 (http://[::]:8000/)
 
 ##### If you have an AI, and are prepared for battle. Modify the URL to battle against your AI. Best out of 3.
 
-###### +Did the audited AI won against your AI?
+###### +Did the audited AI win against your AI?

subjects/ultimatedivmod/README.md

@@ -2,7 +2,7 @@
 
 ### Instructions
 
-- Write a function that will be formatted as below.
+Create the following function.
 
 ### Expected function
 
@@ -11,10 +11,9 @@ func UltimateDivMod(a *int, b *int) {
 
 }
 ```
-
-- This function will divide the `int` **a** and **b**.
-- The result of this division will be stored in the `int` pointed by **a**.
-- The remainder of this division will be stored in the `int` pointed by **b**.
+`UltimateDivMod` should divide the dereferenced value of `a` by the dereferenced value of `b`.
+- Store the result of the division in the `int` which `a` points to.
+- Store the remainder of the division in the `int` which `b` points to.
 
 ### Usage
 

subjects/using-filter/README.md

@@ -2,50 +2,24 @@
 
 ### Instructions
 
-- Create a function `filterShortStateName` that takes an array of
-  strings and that returns the ones with less than 7 characters.
+Create the following functions:
 
-> Example: `'Iowa'` only contains 4 characters
+> Your solutions **must** use `filter`.
 
-- Create a function `filterStartVowel` that takes an array of strings
-  and that returns only the ones that start with a vowel (a,e,i,o,u).
+- `filterShortStateName`: accepts an array of strings, and returns only those strings which contain less than 7 characters.
 
-> Example: `'Alabama'` starts with a vowel
+- `filterStartVowel`: accepts an array of strings, and returns only those that start with any vowel (a,e,i,o,u).
 
-- Create a function `filter5Vowels` that takes an array of strings
-  and that returns only the ones which contain at least 5
-  vowels (a,e,i,o,u).
+- `filter5Vowels`: accepts an array of strings, and returns only those which contain at least 5 of any vowels (a,e,i,o,u).
 
-> Example: `'California'` contains at least 5 vowels
+- `filter1DistinctVowel`: accepts an array of strings, and returns only those which contain distinct vowels (a,e,i,o,u). For example, `"Alabama"` contains only 1 distinct vowel `"a"`.
 
-- Create a function `filter1DistinctVowel` that takes an array of
-  strings and that returns only the ones which vowels are of only
-  one distinct one (a,e,i,o,u).
-
-> Example: `'Alabama'` only contains 1 distinct vowels `'a'`.
-
-- Create a function `multiFilter` that takes an array of
-  objects and that returns only the ones which:
-
-- the key `capital` contains at least 8 characters.
-- the key `name` does not start with a vowel
-- the key `tag` has at least one vowel.
-- the key `region` is not `'South'`
-
-> Example of an array of objects matching the criterias:
-
-```js
-[
-  { tag: 'CA', name: 'California', capital: 'Sacramento', region: 'West' },
-  { tag: 'PA', name: 'Pennsylvania', capital: 'Harrisburg', region: 'Northeast' }
-]
-```
-
-#### Special instruction
-
-The goal of this exercise is to learn to use `filter`, as such all your
-solution **MUST** use `filter`
+- `multiFilter`: accepts an array of objects, and returns only those which:
+  - the key `capital` contains at least 8 characters.
+  - the key `name` does not start with a vowel.
+  - the key `tag` has at least one vowel.
+  - the key `region` is not `"South"`
 
 ### Notions
 
-- [devdocs.io/javascript/global_objects/array/filter](https://devdocs.io/javascript/global_objects/array/filter)
+- [Array.prototype.filter](https://devdocs.io/javascript/global_objects/array/filter)

subjects/using-map/README.md

@@ -2,10 +2,13 @@
 
 ### Instructions
 
-- Create a function named `citiesOnly` which takes an array of objects and which return an array of strings from the key `city`.
+Create the following functions:
 
-#### Example:
+> Your solutions **must** use `map`.
 
+
+#### Cities Only
+`citiesOnly`: accepts an array of objects and returns an array of strings from the `city` key.
 ```js
 citiesOnly([
   {
@@ -19,34 +22,20 @@ citiesOnly([
 ]) // -> ['Los Angeles', 'San Francisco']
 ```
 
-- Create a function named `upperCasingStates` which takes an array of strings
-  and which Upper Case the first letter of each word in a string. \
-  The function returns then an array of strings.
-
-#### Example:
-
+#### Upper Casing States
+`upperCasingStates`: accepts an array of strings, and returns a new array of strings. The returned array will be the same as the argument, except the first letter of every word must be capitalized.
 ```js
 upperCasingStates(['alabama', 'new jersey']) // -> ['Alabama', 'New Jersey']
 ```
 
-- Create a function named `fahrenheitToCelsius` which takes an array
-  of fahrenheit temperatures which converts them to Celsius.
-  Round down the result.
-
-The function then returns the result as an array of strings like below:
-
-#### Example:
-
+#### Fahrenheit to Celsius
+`fahrenheitToCelsius`: accepts an array of fahrenheit temperatures as strings, and returns an array of strings converted to celsius. Round down the result.
 ```js
 fahrenheitToCelsius(['68°F', '59°F', '25°F']) // -> ['20°C', '15°C', '-4°C']
 ```
 
-- Create a function named `trimTemp` which takes an array of objects
-  and which removes the spaces from the string in the key `temperature`. \
-  The function then returns an array of objects with the modification.
-
-#### Example:
-
+#### Trim Temp
+`trimTemp`: accepts an array of objects, and returns a new array of objects with the same structure. The `temperature` strings must have their spaces removed in the new array.
 ```js
 trimTemp([
   { city: 'Los Angeles', temperature: '  101 °F   ' },
@@ -57,9 +46,8 @@ trimTemp([
 ] */
 ```
 
-- Create a `tempForecasts` function which will take an array of objects, and which will
-  return an array of strings formatted as below:
-
+#### Temp Forecasts
+`tempForecasts`: accepts an array of objects, and returns an array of formatted strings. See the example below:
 ```js
 tempForecasts([
   {
@@ -71,11 +59,7 @@ tempForecasts([
 ]) // -> ['38°Celsius in Pasadena, California']
 ```
 
-#### Special instruction
-
-The goal of this exercise is to learn to use `map`, as such all your
-solution **MUST** use `map`
 
 ### Notions
 
-- [devdocs.io/javascript/global_objects/array/map](https://devdocs.io/javascript/global_objects/array/map)
+- [Array.prototype.map](https://devdocs.io/javascript/global_objects/array/map)

subjects/using-reduce/README.md

@@ -2,33 +2,24 @@
 
 ### Instructions
 
-Create three functions :
+Create the following functions:
 
-- `adder` that receives an array and adds its elements.
+> Your solutions **must** use `reduce`.
 
-- `sumOrMul` that receives an array and adds or multiplies its elements
-  depending on whether the element is an odd or an even number, where:
-    - even = multiply
-    - odd = add
+- `adder`: accepts an array of numbers, and returns the sum as a `number`.
 
-- `funcExec` that receives an array of functions and executes them.
+- `sumOrMul`: accepts an array of numbers and adds or multiplies its elements depending on whether the element is odd or even. Even = multiply. Odd = add.
 
-All functions may or may not receive an extra argument that should be the
-initial value for the functions execution.
+- `funcExec`: accepts an array of functions and executes them using `reduce`, returning the result.
 
-Example:
+> Each function may accept an optional argument, which should be the initial value for the function's execution.
 
-```js
-sumOrMul([1, 2, 3, 5, 8], 5)
-  // -> ((((5 + 1) * 2) + 3) + 5) * 8
-  // -> 160
-````
-
-#### Special instruction
+#### Example:
 
-The goal of this exercise is to learn to use `reduce`, as such all your
-solution **MUST** use `reduce`
+```js
+sumOrMul([1, 2, 3, 5, 8], 5) // (((((5 + 1) * 2) + 3) + 5) * 8) -> 160
+```
 
 ### Notions
 
-- [devdocs.io/javascript/global_objects/array/reduce](https://devdocs.io/javascript/global_objects/array/reduce)
+- [Array.prototype.reduce](https://devdocs.io/javascript/global_objects/array/reduce)

subjects/where-do-we-go/README.md

@@ -2,42 +2,47 @@
 
 ### Instructions
 
-Tired of staying home for too long, you decide to develop a page to index ideas for your next travel destinations, so that next time you'll ask yourself 'Where do we go?', you won't need to get lost for 3 hours!
-
-Write the function `explore` which creates a page displaying the list of `places` provided in the data file below:
-
-- sort the `places` from the Northest to the Southest
-- display a fullscreen-size `<section>` for each place ; use the pics hosted in the `./where-do-we-go_images` folder (find the download link below) to set the `background` attribute with the corresponding image URL. The URL has to be formatted like so: `./where-do-we-go_images/name-of-the-place.jpg`
-- display a location indicator as a `<a>` tag in the middle of the screen which:
-  - has the class `location`
-  - displays as text strings separated by `\n`, the `name` and the `coordinates` of the current place featured in the image
-  - using the corresponding `color` as text color
-  - updates the `name`, `coordinates` and `color` on scroll, when the top of the next image reaches the middle of the screen height
-  - has the `href` attribute set to open **a new tab** redirecting to a Google Maps' URL with the coordinates of the place currently displayed
-- display a compass as a `div` tag indicating the latitude direction which:
+Where will you go on your next holiday?
+
+Let's make a page to index your options, so that next time you ask yourself that question, you'll be ready with some ideas.
+
+Create a function named `explore`, which creates a page displaying the list of `places` provided in the data file below.
+
+- sort the `places` from north to south, so that the northern-most place is first.
+- display a fullscreen-size `<section>` for each place. Use the pics hosted in the `./where-do-we-go_images` folder below. Set the `background` attribute with the corresponding image URL. The URL has to be formatted like so: `./where-do-we-go_images/name-of-the-place.jpg`.
+- display a location indicator as an `<a>` tag in the middle of the screen. It should:
+  - have the class `location`
+  - display the `name` and `coordinates` of the current place, as text strings separated by `\n`.
+  - set the text color as `color`.
+  - update the `name`, `coordinates` and `color` on scroll, at the point when the next image reaches the middle of the screen height.
+  - make the `href` attribute open **a new tab** redirecting to a Google Maps URL with the coordinates of the place currently displayed.
+- display a compass as a `div` tag, indicating the latitude direction which:
   - has the class `direction`
   - displays `N` for North if the user is scrolling up
   - displays `S` for South if he's scrolling down
 
-### Notions
-
-- [Scroll event](https://developer.mozilla.org/en-US/docs/Web/API/Element/scroll_event)
-- [`window`](https://developer.mozilla.org/en-US/docs/Web/API/Window): [`innerHeight`](https://developer.mozilla.org/en-US/docs/Web/API/Window/innerHeight), [`scrollY`](https://developer.mozilla.org/en-US/docs/Web/API/Window/scrollY), [`pageYOffset`](https://developer.mozilla.org/en-US/docs/Web/API/Window/pageYOffset)
-- Take a look at the [DMS coordinates system](https://en.wikipedia.org/wiki/Decimal_degrees)
-
 ### Files
 
-You only need to create & submit the JS file `where-do-we-go.js` ; we're providing you the following files to download (click right and save link) & test locally:
+You only need to create & submit the JS file `where-do-we-go.js`; we're providing you the following files to download and test test locally:
 
 - the HTML file [where-do-we-go.html](./where-do-we-go.html) to open in the browser, which includes:
 
-  - the JS script which will allow to run your code
-  - some CSS pre-styled classes: feel free to use those as they are, or modify them
+  - the JS script which will enable you to run your code
+  - some CSS pre-styled classes: feel free to use those as they are, or modify them.
 
-- the data file [where-do-we-go.data.js](./where-do-we-go.data.js) from which you can import `places`
+- the data file [where-do-we-go.data.js](./where-do-we-go.data.js) from which you can import `places`.
 
-- the images to use, in this [compressed folder](https://assets.01-edu.org/where-do-we-go_images.zip)
+- the images to use, in this [compressed folder](https://assets.01-edu.org/where-do-we-go_images.zip).
 
 ### Expected result
 
 You can see an example of the expected result [here](https://youtu.be/BLxNi1WH6_0)
+
+### Notions
+
+- [Scroll event](https://developer.mozilla.org/en-US/docs/Web/API/Element/scroll_event)
+- [window](https://developer.mozilla.org/en-US/docs/Web/API/Window)
+- [innerHeight](https://developer.mozilla.org/en-US/docs/Web/API/Window/innerHeight)
+- [scrollY](https://developer.mozilla.org/en-US/docs/Web/API/Window/scrollY)
+- [pageYOffset](https://developer.mozilla.org/en-US/docs/Web/API/Window/pageYOffset)
+- Take a look at the [DMS coordinates system](https://en.wikipedia.org/wiki/Decimal_degrees)