diff --git a/subjects/sortable/README.md b/subjects/sortable/README.md
index 6ccc4c107..d7969f433 100644
--- a/subjects/sortable/README.md
+++ b/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 `
` 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 `
` 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 `