diff --git a/README.md b/README.md
index 680e0ee..9ae362d 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # dotfiles
 
-.files
+My configuration files for various programs.
 
 ## Installing
 
@@ -10,11 +10,11 @@ To link the files to the correct places run
 ./install.fish
 ```
 
-Make sure you have fish installed.
+Make sure you have [fish](https://fishshell.com) installed.
 
-### How it works
+## How it works
 
 The script takes the directories in `dirs.list` and creats them (if they don't
 exist). After that it runs over `links.list` and takes the first path as source
 (appending ~/dotfiles) and the path after the space as the target (appending
-only ~/).
+only `~/`).