diff --git a/README.md b/README.md
index 4f7b74f..bb9276f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,28 @@
-# us_int
-Alternative US international keyboard layout to write french
+# us_int_fr
+Alternative US international keyboard layout to write french (make french accents reachable only with `Alt Gr`)
+
+## Differences from US international layout
+
+* (case sensible) `Alt Gr` + 
+  * `Q` -> `Â`
+  * `R` -> `Ê`
+  * `Y` -> `Û`
+  * `U` -> `Ù`
+  * `I` -> `Î`
+  * `P` -> `Ô`
+  * `A` -> `À`
+  * `F` -> `È`
+  * `J` -> `Ï`
+* Other
+  * `Alt Gr` + `.` -> `·`
+  * No dead keys for quote and tick
+
+
+## Layout with `Alt Gr`
+
+![](https://user-images.githubusercontent.com/12103162/106765286-eddfc900-6638-11eb-9baa-c501bb444e17.png)
+
+
+## Layout with `Alt Gr` + `Shift`
+
+![](https://user-images.githubusercontent.com/12103162/106765468-1ebffe00-6639-11eb-9731-a3f6f9c97ade.png)