diff --git a/README.rst b/README.rst
index f13b316eebef43fe2ce6f8d7c909c944c43da346..5bef29dc8b93c6618c31f310588f7781ef66dcd3 100644
--- a/README.rst
+++ b/README.rst
@@ -1,2 +1,13 @@
-# diceware
-Passphrases to remember
+diceware
+========
+
+Passphrases you will remember...
+
+`diceware` is a password generator following the proposals of
+Arnold G. Reinhold on http://diceware.com .
+
+With `diceware` you can generate passwords that are build from word
+lists.
+
+While `diceware` provides by no means strong cryptography, you might
+find it useful for not too risky tasks.