diff --git a/README.md b/README.md
index 14309b5..8debabc 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,10 @@
 # Linkedin posts scrapper
 
+Quick & Dirty linkedin scraper to generate a hugo website from a user LinkedIn posts.
+
+- 1. run `scrape.py`
+- 2. then `gen_content.py` to generate markdown files
+- 3. then `propagate_title_change_to_slug.py` after you've changed each post title to something more useful
+- 4. then `construct_hugo_content_links.py` to generate symbolic links to the structured folder (with dates)
+
+