diff --git a/README.md b/README.md
index e6f9574..45cd86b 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,15 @@
 # polybar-scripts
+
+This is a community project. We collect scripts for polybar!
+
+
+To find out how to write and use your own scripts, read the [polybar wiki](https://github.com/jaagr/polybar/wiki). This repository is not an exact blueprint. I guess every script has to be customized to make your polybar unique.
+
+Yours isn't here? Send us your pull request.
+
+
+## See also these other user repositories:
+
+* [vyachkonovalov/polybar-gmail](https://github.com/vyachkonovalov/polybar-gmail): A Polybar module to show unread messages from Gmail
+* [0nse/now_playing](https://github.com/0nse/now_playing): Output the currently scrobbling song
+* [dakuten/taskwarrior-polybar](https://github.com/dakuten/taskwarrior-polybar): merely just a script showing the most urgent task and allowing it to be marked done