diff --git a/subjects/alphamirror.en.md b/subjects/alphamirror.en.md
index 15cdf45e..96058e43 100644
--- a/subjects/alphamirror.en.md
+++ b/subjects/alphamirror.en.md
@@ -2,7 +2,7 @@
 
 ### Instructions
 
-Write a program called alphamirror that takes a string as argument and displays this string
+Write a program called `alphamirror` that takes a `string` as argument and displays this `string`
 after replacing each alphabetical character with the opposite alphabetical
 character.
 
@@ -11,11 +11,11 @@ The case of the letter stays the same, for example :
 'a' becomes 'z', 'Z' becomes 'A'
 'd' becomes 'w', 'M' becomes 'N'
 
-The final result will be followed by a newline.
+The final result will be followed by a newline(`'\n'`).
 
-If the number of arguments is not 1, the program will display only a newline.
+If the number of arguments is not 1, the program displays only a newline(`'\n'`).
 
-Example of output :
+### Usage
 
 ```console
 student@ubuntu:~/student/alphamirror$ go build
diff --git a/subjects/alphamirror.fr.md b/subjects/alphamirror.fr.md
index 15cdf45e..4d897c19 100644
--- a/subjects/alphamirror.fr.md
+++ b/subjects/alphamirror.fr.md
@@ -2,20 +2,18 @@
 
 ### Instructions
 
-Write a program called alphamirror that takes a string as argument and displays this string
-after replacing each alphabetical character with the opposite alphabetical
-character.
+Écrire un programme nommé `alphamirror` qui prend une `string` come argument et qui affiche cette `string` après remplacement de chaque charactère alphabétique avec son opposé.
 
-The case of the letter stays the same, for example :
+Les majuscules restent des majuscules, de même pour le minuscules, par exemple :
 
-'a' becomes 'z', 'Z' becomes 'A'
-'d' becomes 'w', 'M' becomes 'N'
+'a' devient 'z', 'Z' devient 'A'
+'d' devient 'w', 'M' devient 'N'
 
-The final result will be followed by a newline.
+Le résultat final sera suivi d'un newline(`'\n'`).
 
-If the number of arguments is not 1, the program will display only a newline.
+Si le nombre d'arguments n'est pas 1, le programme affiche seulement un newline(`'\n'`).
 
-Example of output :
+### Utilisation
 
 ```console
 student@ubuntu:~/student/alphamirror$ go build
diff --git a/subjects/displayfirstparam.en.md b/subjects/displayfirstparam.en.md
index 5ce79b29..2f0cffae 100644
--- a/subjects/displayfirstparam.en.md
+++ b/subjects/displayfirstparam.en.md
@@ -2,9 +2,9 @@
 
 ### Instructions
 
-Write a program that takes strings as arguments, and displays its first argument.
+Write a program that takes `strings` as arguments, and displays its first argument.
 
-### Expected output
+### Usage
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/displayfirstparam.fr.md b/subjects/displayfirstparam.fr.md
index 5ce79b29..4b50eeb9 100644
--- a/subjects/displayfirstparam.fr.md
+++ b/subjects/displayfirstparam.fr.md
@@ -2,9 +2,9 @@
 
 ### Instructions
 
-Write a program that takes strings as arguments, and displays its first argument.
+Écrire un programme qui prend des `strings` comme arguments, et qui affiche le premier argument.
 
-### Expected output
+### Utilisation
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/displaylastparam.en.md b/subjects/displaylastparam.en.md
index e943c6c6..557c4759 100644
--- a/subjects/displaylastparam.en.md
+++ b/subjects/displaylastparam.en.md
@@ -2,7 +2,7 @@
 
 ### Instructions
 
-Write a program that takes strings as arguments, and displays its last argument.
+Write a program that takes `strings` as arguments, and displays its last argument.
 
 ### Expected output
 
diff --git a/subjects/displaylastparam.fr.md b/subjects/displaylastparam.fr.md
index e943c6c6..8114ee0b 100644
--- a/subjects/displaylastparam.fr.md
+++ b/subjects/displaylastparam.fr.md
@@ -2,7 +2,7 @@
 
 ### Instructions
 
-Write a program that takes strings as arguments, and displays its last argument.
+Écrire un programme qui prend des `strings` comme arguments, et qui affiche le dernier argument.
 
 ### Expected output
 
diff --git a/subjects/firstword.en.md b/subjects/firstword.en.md
index d704bbbd..13ada597 100644
--- a/subjects/firstword.en.md
+++ b/subjects/firstword.en.md
@@ -2,15 +2,15 @@
 
 ### Instructions
 
-Write a program that takes a string and displays its first word, followed by a newline.
+Write a program that takes a `string` and displays its first word, followed by a newline(`'\n'`).
 
-- A word is a section of string delimited by spaces or by the start/end of the string.
+- A word is a section of `string` delimited by spaces or by the start/end of the `string`.
 
-- The output will be followed by a newline.
+- The output will be followed by a newline(`'\n'`).
 
-- If the number of parameters is not 1, or if there are no words, simply display a newline.
+- If the number of parameters is not 1, or if there are no words, the program displays a newline(`'\n'`).
 
-### Expected output
+### Usage
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/firstword.fr.md b/subjects/firstword.fr.md
index d704bbbd..4eedf04c 100644
--- a/subjects/firstword.fr.md
+++ b/subjects/firstword.fr.md
@@ -2,15 +2,15 @@
 
 ### Instructions
 
-Write a program that takes a string and displays its first word, followed by a newline.
+Écrire un programme qui prend une `string` et qui affiche son premier mot, suivi d'un newline(`'\n'`).
 
-- A word is a section of string delimited by spaces or by the start/end of the string.
+- Un mot est une section de `string` délimité par des espace ou par le début/fin d'une `string`.
 
-- The output will be followed by a newline.
+- L'output sera suivi d'un newline(`'\n'`).
 
-- If the number of parameters is not 1, or if there are no words, simply display a newline.
+- Si le nombre de paramètres n'est pas 1, ou si il n'y a pas de mots, le programme affiche un newline(`'\n'`).
 
-### Expected output
+### Utilisation
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/inter.en.md b/subjects/inter.en.md
index daf9625f..4a91443d 100644
--- a/subjects/inter.en.md
+++ b/subjects/inter.en.md
@@ -1,14 +1,14 @@
-## switchcase
+## inter
 
 ### Instructions
 
-Write a program that takes two strings and displays, without doubles, the characters that appear in both strings, in the order they appear in the first one.
+Write a program that takes two `strings` and displays, without doubles, the characters that appear in both `strings`, in the order they appear in the first one.
 
-- The display will be followed by a `\n`.
+- The display will be followed by a newline(`'\n'`).
 
-- If the number of arguments is not 2, the program displays `\n`.
+- If the number of arguments is not 2, the program displays a newline(`'\n'`).
 
-### Expected output
+### Usage
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/inter.fr.md b/subjects/inter.fr.md
index daf9625f..682f59f2 100644
--- a/subjects/inter.fr.md
+++ b/subjects/inter.fr.md
@@ -1,14 +1,14 @@
-## switchcase
+## inter
 
 ### Instructions
 
-Write a program that takes two strings and displays, without doubles, the characters that appear in both strings, in the order they appear in the first one.
+Écrire un programme qui prend deux `strings` et qui affiche, sans doublons, les caractères qui apparaissent dans les deux `strings`, dans l'ordre dans lequel ils apparaissent dans la première.
 
-- The display will be followed by a `\n`.
+- L'affichage sera suivi d'un newline(`'\n'`).
 
-- If the number of arguments is not 2, the program displays `\n`.
+- Si le nombre d'arguments n'est pas 2, le programme affiche un newline(`'\n'`).
 
-### Expected output
+### Utilisation
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/lastword.en.md b/subjects/lastword.en.md
index c1a68ead..0efe663c 100644
--- a/subjects/lastword.en.md
+++ b/subjects/lastword.en.md
@@ -2,16 +2,15 @@
 
 ### Instructions
 
-Write a program that takes a string and displays its last word, followed by a
-newline.
+Write a program that takes a `string` and displays its last word, followed by a newline(`'\n'`).
 
-A word is a section of string delimited by spaces/tabs or by the start/end of
-the string.
+- A word is a section of `string` delimited by spaces or by the start/end of the `string`.
 
-If the number of parameters is not 1, or if there are no words, simply display
-a newline.
+- The output will be followed by a newline(`'\n'`).
 
-Example :
+- If the number of parameters is not 1, or if there are no words, the program displays a newline(`'\n'`).
+
+### Usage
 
 ```console
 student@ubuntu:~/student/lastword$ go build
diff --git a/subjects/lastword.fr.md b/subjects/lastword.fr.md
index c1a68ead..d56a3a51 100644
--- a/subjects/lastword.fr.md
+++ b/subjects/lastword.fr.md
@@ -2,16 +2,15 @@
 
 ### Instructions
 
-Write a program that takes a string and displays its last word, followed by a
-newline.
+Écrire un programme qui prend une `string` et qui affiche son dernier mot, suivi d'un newline(`'\n'`).
 
-A word is a section of string delimited by spaces/tabs or by the start/end of
-the string.
+- Un mot est une section de `string` délimité par des espace ou par le début/fin d'une `string`.
 
-If the number of parameters is not 1, or if there are no words, simply display
-a newline.
+- L'output sera suivi d'un newline(`'\n'`).
 
-Example :
+- Si le nombre de paramètres n'est pas 1, ou si il n'y a pas de mots, le programme affiche un newline(`'\n'`).
+
+### Utilisation
 
 ```console
 student@ubuntu:~/student/lastword$ go build
diff --git a/subjects/repeatalpha.en.md b/subjects/repeatalpha.en.md
index 558123b9..ad4a4964 100644
--- a/subjects/repeatalpha.en.md
+++ b/subjects/repeatalpha.en.md
@@ -2,17 +2,18 @@
 
 ### Instructions
 
-Write a program called repeat_alpha that takes a string and display it
-repeating each alphabetical character as many times as its alphabetical index,
-followed by a newline.
+Write a program called `repeat_alpha` that takes a `string` and displays it
+repeating each alphabetical character as many times as its alphabetical index.
+
+The result must be followed by a newline(`'\n'`).
 
 `'a'` becomes `'a'`, `'b'` becomes `'bb'`, `'e'` becomes `'eeeee'`, etc...
 
-Case remains unchanged.
+The case remains unchanged.
 
-If the number of arguments is not 1, just display a newline.
+If the number of arguments is not 1, the program displays a newline(`'\n'`).
 
-Examples:
+### Usage
 
 ```console
 student@ubuntu:~/student/repeatalpha$ go build
diff --git a/subjects/repeatalpha.fr.md b/subjects/repeatalpha.fr.md
index 558123b9..7b1b4e76 100644
--- a/subjects/repeatalpha.fr.md
+++ b/subjects/repeatalpha.fr.md
@@ -2,17 +2,17 @@
 
 ### Instructions
 
-Write a program called repeat_alpha that takes a string and display it
-repeating each alphabetical character as many times as its alphabetical index,
-followed by a newline.
+Écrire un programme `repeat_alpha` qui prend une `string` et qui affiche la répétition de chaque charactère de l'alpabet autant de fois que l'index de cette lettre.
 
-`'a'` becomes `'a'`, `'b'` becomes `'bb'`, `'e'` becomes `'eeeee'`, etc...
+Le résultat doit être suivi d'un newline(`'\n'`).
 
-Case remains unchanged.
+`'a'` deviens `'a'`, `'b'` deviens `'bb'`, `'e'` deviens `'eeeee'`, etc...
 
-If the number of arguments is not 1, just display a newline.
+Si une lettre est majuscule, elle reste majuscule, de même si elle est minuscule.
 
-Examples:
+Si le nombre d'arguments n'est pas 1, le programme affiche un newline(`'\n'`).
+
+### Utilisation
 
 ```console
 student@ubuntu:~/student/repeatalpha$ go build
diff --git a/subjects/reversebits.en.md b/subjects/reversebits.en.md
index 886af231..d812f1cf 100644
--- a/subjects/reversebits.en.md
+++ b/subjects/reversebits.en.md
@@ -2,10 +2,10 @@
 
 ### Instructions
 
-Write a function that takes a byte, reverses it, bit by bit (like the
+Write a function that takes a `byte`, reverses it `bit` by `bit` (like the
 example) and returns the result.
 
-Your function must be declared as follows:
+### Expected function
 
 ```go
 func ReverseBits(octet byte) byte {
diff --git a/subjects/reversebits.fr.md b/subjects/reversebits.fr.md
index 886af231..a22d6a85 100644
--- a/subjects/reversebits.fr.md
+++ b/subjects/reversebits.fr.md
@@ -2,10 +2,9 @@
 
 ### Instructions
 
-Write a function that takes a byte, reverses it, bit by bit (like the
-example) and returns the result.
+Écrire une fonction qui prend un `byte`, l'inverse `bit` par `bit` (comme sur l'exemple) et retourne le résultat.
 
-Your function must be declared as follows:
+### Fonction attendue
 
 ```go
 func ReverseBits(octet byte) byte {
@@ -13,7 +12,7 @@ func ReverseBits(octet byte) byte {
 }
 ```
 
-Example:
+Exemple:
 
 1 byte
 
diff --git a/subjects/rot13.en.md b/subjects/rot13.en.md
index 56619229..7cee82cd 100644
--- a/subjects/rot13.en.md
+++ b/subjects/rot13.en.md
@@ -2,16 +2,16 @@
 
 ### Instructions
 
-Write a program that takes a string and displays it, replacing each of its
+Write a program that takes a `string` and displays it, replacing each of its
 letters by the letter 13 spaces ahead in alphabetical order.
 
 - 'z' becomes 'm' and 'Z' becomes 'M'. Case remains unaffected.
 
-- The output will be followed by a newline.
+- The output will be followed by a newline(`'\n'`).
 
-- If the number of arguments is not 1, the program displays a newline.
+- If the number of arguments is not 1, the program displays a newline(`'\n'`).
 
-### Expected output
+### Usage
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/rot13.fr.md b/subjects/rot13.fr.md
index 56619229..b33d27e5 100644
--- a/subjects/rot13.fr.md
+++ b/subjects/rot13.fr.md
@@ -2,16 +2,15 @@
 
 ### Instructions
 
-Write a program that takes a string and displays it, replacing each of its
-letters by the letter 13 spaces ahead in alphabetical order.
+Écrire un programme qui prend une `string` et qui l'affiche, en remplaçant chacune de ses lettres par la lettre 13 positions après dans l'ordre alphabétique.
 
-- 'z' becomes 'm' and 'Z' becomes 'M'. Case remains unaffected.
+- 'z' devient 'm' et 'Z' devient 'M'. Les majuscules restent des majuscules, de même pour les minuscules.
 
-- The output will be followed by a newline.
+- l'output sera suivi d'un newline(`'\n'`).
 
-- If the number of arguments is not 1, the program displays a newline.
+- Si le nombre d'arguments n'est pas 1, le programme affiche un newline(`'\n'`).
 
-### Expected output
+### Utilisation
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/searchreplace.en.md b/subjects/searchreplace.en.md
index 861667ad..7b426b9b 100644
--- a/subjects/searchreplace.en.md
+++ b/subjects/searchreplace.en.md
@@ -2,13 +2,13 @@
 
 ### Instructions
 
-Write a program that takes 3 arguments, the first arguments is a string in which to replace a letter (2nd argument) by another one (3rd argument).
+Write a program that takes 3 arguments, the first argument is a `string` in which to replace a letter (the 2nd argument) by another one (the 3rd argument).
 
-- If the number of arguments is not 3, just display a newline.
+- If the number of arguments is not 3, the program displays a newline(`'\n'`).
 
-- If the second argument is not contained in the first one (the string) then the program simply rewrites the string followed by a newline.
+- If the second argument is not contained in the first one (the string) then the program rewrites the `string` followed by a newline(`'\n'`).
 
-### Expected output
+### Usage
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/searchreplace.fr.md b/subjects/searchreplace.fr.md
index 861667ad..704ae2a6 100644
--- a/subjects/searchreplace.fr.md
+++ b/subjects/searchreplace.fr.md
@@ -2,13 +2,13 @@
 
 ### Instructions
 
-Write a program that takes 3 arguments, the first arguments is a string in which to replace a letter (2nd argument) by another one (3rd argument).
+Écrire un programme qui prends 3 arguments, le premier argument est une `string` dans laquelle une lettre (le 2éme argument) est remplacée par une autre (3éme argument).
 
-- If the number of arguments is not 3, just display a newline.
+- Si le nombre d'aruments n'est pas 3, le programme affiche un newline(`'\n'`).
 
-- If the second argument is not contained in the first one (the string) then the program simply rewrites the string followed by a newline.
+- Si le second argument n'est pas contenu dans le premier (la `string`) alors le programme réécris la `string` suivi d'un newline(`'\n'`).
 
-### Expected output
+### Utilisation
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/swapbits.en.md b/subjects/swapbits.en.md
index 2e5bfafb..d6fb0d02 100644
--- a/subjects/swapbits.en.md
+++ b/subjects/swapbits.en.md
@@ -2,10 +2,10 @@
 
 ### Instructions
 
-Write a function that takes a byte, swaps its halves (like the example) and
-returns the result.
+Write a function that takes a `byte`, swaps its halfs (like the
+example) and returns the result.
 
-Your function must be declared as follows:
+### Expected function
 
 ```go
 func SwapBits(octet byte) byte {
diff --git a/subjects/swapbits.fr.md b/subjects/swapbits.fr.md
index 2e5bfafb..679fe936 100644
--- a/subjects/swapbits.fr.md
+++ b/subjects/swapbits.fr.md
@@ -2,10 +2,9 @@
 
 ### Instructions
 
-Write a function that takes a byte, swaps its halves (like the example) and
-returns the result.
+Écrire une fonction qui prend un `byte`, échange ses moitiés (comme sur l'exemple) et retourne le résultat.
 
-Your function must be declared as follows:
+### Fonction attendue
 
 ```go
 func SwapBits(octet byte) byte {
@@ -13,7 +12,7 @@ func SwapBits(octet byte) byte {
 }
 ```
 
-Example:
+Exemple:
 
 1 byte
 
diff --git a/subjects/switchcase.en.md b/subjects/switchcase.en.md
index ef836406..3cd4addb 100644
--- a/subjects/switchcase.en.md
+++ b/subjects/switchcase.en.md
@@ -2,15 +2,15 @@
 
 ### Instructions
 
-Write a program that takes a string and reverses the case of all its letters.
+Write a program that takes a `string` and reverses the case of all its letters.
 
 - Other characters remain unchanged.
 
-- You must display the result followed by a '\n'.
+- The result must be followed by a newline(`'\n'`).
 
-- If the number of arguments is not 1, the program displays '\n'.
+- If the number of arguments is not 1, the program displays a newline(`'\n'`).
 
-### Expected output
+### Usage
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/switchcase.fr.md b/subjects/switchcase.fr.md
index ef836406..e2ee6d33 100644
--- a/subjects/switchcase.fr.md
+++ b/subjects/switchcase.fr.md
@@ -2,15 +2,15 @@
 
 ### Instructions
 
-Write a program that takes a string and reverses the case of all its letters.
+Écrire un programme qui prend une `string` et qui inverses les majuscules en minuscules et vice-versa.
 
-- Other characters remain unchanged.
+- Tout autre charactère reste inchangé.
 
-- You must display the result followed by a '\n'.
+- Le résultat doit être suivi d'un newline(`'\n'`).
 
-- If the number of arguments is not 1, the program displays '\n'.
+- Si le nombre d'arguments n'est pas 1, le programme affiche program un newline(`'\n'`).
 
-### Expected output
+### Utilisation
 
 ```console
 student@ubuntu:~/piscine/test$ go build
diff --git a/subjects/union.en.md b/subjects/union.en.md
index 6348bc42..278835d9 100644
--- a/subjects/union.en.md
+++ b/subjects/union.en.md
@@ -2,15 +2,15 @@
 
 ### Instructions
 
-Write a program that takes two strings and displays, without doubles, the
-characters that appear in either one of the strings.
+Write a program that takes two `strings` and displays, without doubles, the
+characters that appear in either one of the `strings`.
 
 The display will be in the order characters appear in the command line, and
-will be followed by a \n.
+will be followed by a newline(`'\n'`).
 
-If the number of arguments is not 2, the program displays \n.
+If the number of arguments is not 2, the program displays newline(`'\n'`).
 
-Example :
+### Usage
 
 ```console
 student@ubuntu:~/student/union$ go build
diff --git a/subjects/union.fr.md b/subjects/union.fr.md
index 6348bc42..cbc35ef2 100644
--- a/subjects/union.fr.md
+++ b/subjects/union.fr.md
@@ -2,15 +2,13 @@
 
 ### Instructions
 
-Write a program that takes two strings and displays, without doubles, the
-characters that appear in either one of the strings.
+Écrire un programme qui prend deux `strings` et affiche, sans doublons, les caractères qui apparaissent dans l'une ou l'autre des `strings`.
 
-The display will be in the order characters appear in the command line, and
-will be followed by a \n.
+L'affichage se fera dans l'ordre d'apparition des caractères de la ligne de commande, et il sera suivi d'un newline(`'\n'`).
 
-If the number of arguments is not 2, the program displays \n.
+Si le nombre d'arguments n'est pas 2, le programme affiche un newline(`'\n'`).
 
-Example :
+### Utilisation
 
 ```console
 student@ubuntu:~/student/union$ go build