diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c2a5074
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# Gentoo overlay
+
+This overlay aims to provide some ebuilds that I need and are not in the
+official repo or in another overlay.
+
+If some package is broken, you could open an issue here or send me an email or
+contact me via IRC.
+
+## Example of repo.conf
+
+```
+[SwordArMor]
+location = /usr/local/overlay/SwordArMor
+sync-type = git
+sync-uri = https://git.grifon.fr/alarig/SwordArMor-gentoo-overlay.git
+auto-sync = yes
+```