diff --git a/.gitignore b/.gitignore
index 1cd791b..b2be92b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1 @@
-result/
+result
diff --git a/README.md b/README.md
index 9783efe..2766e81 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,19 @@
 # linkedin_blog
 
-a collection of article posted on linkedin using markdown and presenterm
\ No newline at end of file
+a collection of article posted on linkedin using markdown and presenterm
+
+## File structure
+src/
+  configs/: Base configuration for presenterm
+  posts/: Posts, organized by topic
+  scripts/: Scripts used by the build process
+  Makefile: Makefile used by the build process
+
+## Usage
+### With nix
+`nix developp`: launch a shell with presenterm and weasyprint allowing the user
+to easely preview the slides in his terminal.  
+`nix build`: will build all the posts in a **result/** folder
+### With a package manager
+install `presenterm` and optionally `weasyprint` to preview and/or export each
+posts. 
diff --git a/src/output/nginx.pdf b/src/output/nginx.pdf
deleted file mode 100644
index fc4731f..0000000
Binary files a/src/output/nginx.pdf and /dev/null differ
diff --git a/src/output/vue.pdf b/src/output/vue.pdf
deleted file mode 100644
index a8da58c..0000000
Binary files a/src/output/vue.pdf and /dev/null differ