diff --git a/readme.md b/readme.md
index 78f4a72..ef8b5f6 100755
--- a/readme.md
+++ b/readme.md
@@ -1,36 +1,38 @@
 ## Just another repo of Python scripts
 
-1. **01_remove_all_pyc.md**: remove all *.pyc* files from a git repo
-1. **02_find_all_links.py**: get all links from a webpage
-1. **03_simple_twitter_manager.py**: accessing the Twitter API, example functions
-1. **04_rename_with_slice.py**: rename group of files, within a single directory, using slice
-1. **05_load_json_without_dupes.py**: load JSON, convert to dict, raise error if there is a duplicate key
-1. **06_execution_time.py**: class used for timing execution of code
-1. **07_benchmark_permissions_loading_django.py**: benchmark loading of permissions in Django
-1. **08_basic_email_web_crawler.py**: web crawler for grabbing emails from a website
-1. **09_basic_link_web_crawler.py**: web crawler for grabbing links from a website
-1. **10_find_files_recursively.py**: recursively grab files from a directory
-1. **11_optimize_images_with_wand.py**: recursively grab images from a directory, then optimize them for the web
-1. **12_csv_split.py**: Splits a CSV file into multiple files based on command line arguments.
-1. **13_random_name_generator.py**: random name generator
-1. **14_html_to_markdown.sh**: Convert all html files in a single directory to markdown
-1. **15_check_my_environment.py**: Pass in a config file based on your environment.
-1. **16_jinja_quick_load.py**: Render a quick Jinja2 template
-1. **17_rewrite_git_history.md**: Backdating/Rewriting Git history (use at your own risk)
-1. **18_zipper.py**: Zip contents of a directory, adding a timestamp to the filename
-1. **19_tsv-to-csv.py**: Convert TSV to CSV
-1. **20_restore_file_from_git.py**: Restore file from Git History
-1. **21_twitter_bot.py**: Twitter Bot
-1. **22_git_tag.py**: Create Git Tag based on a commit
-1. **23_flask_session_test.py**: Just a simple app to see if the sessions are working
-1. **24_sql2csv.py**: SQL to CSV.
-1. **25_ip2geolocation.py**: Given a CSV file with an ip address (see sample - *25_sample_csv.csv*), return the geolocation based on the ip.
-1. **26_stock_scraper.py**: Scrape the S&P 500 Companies list from Wikipedia, then output the data.
-1. **27_send_sms.py**: Send SMS message via [TextBelt](http://textbelt.com/)
-1. **28_income_tax_calculator.py**: Income tax calculator via [Taxee](http://taxee.io/)
-1. **29_json_to_yaml.py**: Convert JSON to YAML
-1. **30_fullcontact.py**: Call the [FullcContact](https://www.fullcontact.com/developer/) API
-1. **31_youtube_sentiment.py**: Calculate sentiment score from the comments of a Youtube video
-1. **32_stock_scraper.py**: Get stock prices
-1. **33_country_code.py**: Convert country code to country name
-1. **34_git_all_repos.py**: Clone all repositories from a public user or organization on Github. Usage: `python git_all_repos.py users USER_NAME` or `python git_all_repos.py orgs ORG_NAME`
+|NO| script name  | description |
+|--|:-------------:| :-------------:|
+|01|[remove_all_pyc.md](https://github.com/realpython/python-scripts/tree/master/scripts/01_remove_all_pyc.md)| "remove all *.pyc* files from a git repo"|
+|02|[find_all_links.py](https://github.com/realpython/python-scripts/tree/master/scripts/02_find_all_links.py)|"get all links from a webpage"|
+|03|[simple_twitter_manager.py](https://github.com/realpython/python-scripts/tree/master/scripts/03_simple_twitter_manager.py)| "accessing the Twitter API, example functions"|
+|04| [rename_with_slice.py](https://github.com/realpython/python-scripts/tree/master/scripts/04_rename_with_slice.py)|"rename group of files, within a single directory, using slice"|
+|05| [load_json_without_dupes.py](https://github.com/realpython/python-scripts/tree/master/scripts/05_load_json_without_dupes.py)| "load JSON, convert to dict, raise error if there is a duplicate key"|
+|06| [execution_time.py](https://github.com/realpython/python-scripts/tree/master/scripts/06_execution_time.py)| "class used for timing execution of code"|
+|07| [benchmark_permissions_loading_django.py](https://github.com/realpython/python-scripts/tree/master/scripts/07_benchmark_permissions_loading_django.py)| "benchmark loading of permissions in Django"|
+|08| [basic_email_web_crawler.py](https://github.com/realpython/python-scripts/tree/master/scripts/08_basic_email_web_crawler.py)|"web crawler for grabbing emails from a website"|
+|09| [basic_link_web_crawler.py](https://github.com/realpython/python-scripts/tree/master/scripts/09_basic_link_web_crawler.py)| "web crawler for grabbing links from a website"|
+|10| [find_files_recursively.py](https://github.com/realpython/python-scripts/tree/master/scripts/10_find_files_recursively.py)| "recursively grab files from a directory"|
+|11| [optimize_images_with_wand.py](https://github.com/realpython/python-scripts/tree/master/scripts/11_optimize_images_with_wand.py)| "recursively grab images from a directory, then optimize them for the web"|
+|12| [csv_split.py](https://github.com/realpython/python-scripts/tree/master/scripts/12_csv_split.py)| "Splits a CSV file into multiple files based on command line arguments"|
+|13| [random_name_generator.py](https://github.com/realpython/python-scripts/tree/master/scripts/13_random_name_generator.py)|"random name generator"|
+|14| [html_to_markdown.sh](https://github.com/realpython/python-scripts/tree/master/scripts/14_html_to_markdown.sh)| "Convert all html files in a single directory to markdown"|
+|15| [check_my_environment.py](https://github.com/realpython/python-scripts/tree/master/scripts/15_check_my_environment.py)| "Pass in a config file based on your environment"|
+|16| [jinja_quick_load.py](https://github.com/realpython/python-scripts/tree/master/scripts/16_jinja_quick_load.py)| "Render a quick Jinja2 template"|
+|17| [rewrite_git_history.md](https://github.com/realpython/python-scripts/tree/master/scripts/17_rewrite_git_history.md)| "Backdating/Rewriting Git history (use at your own risk)"|
+|18| [zipper.py](https://github.com/realpython/python-scripts/tree/master/scripts/18_zipper.py)|"Zip contents of a directory, adding a timestamp to the filename"|
+|19| [tsv-to-csv.py](https://github.com/realpython/python-scripts/tree/master/scripts/19_tsv-to-csv.py)| "Convert TSV to CSV"|
+|20| [restore_file_from_git.py](https://github.com/realpython/python-scripts/tree/master/scripts/20_restore_file_from_git.py)| "Restore file from Git History"|
+|21| [twitter_bot.py](https://github.com/realpython/python-scripts/tree/master/scripts/21_twitter_bot.py)| "Twitter Bot"|
+|22| [git_tag.py](https://github.com/realpython/python-scripts/tree/master/scripts/22_git_tag.py)| "Create Git Tag based on a commit"|
+|23| [flask_session_test.py](https://github.com/realpython/python-scripts/tree/master/scripts/23_flask_session_test.py)| "Just a simple app to see if the sessions are working"|
+|24| [sql2csv.py](https://github.com/realpython/python-scripts/tree/master/scripts/24_sql2csv.py)|"SQL to CSV"|
+|25| [ip2geolocation.py](https://github.com/realpython/python-scripts/tree/master/scripts/25_ip2geolocation.py)|"Given a CSV file with an ip address (see sample - *25_sample_csv.csv*), return the geolocation based on the ip"|
+|26| [stock_scraper.py](https://github.com/realpython/python-scripts/tree/master/scripts/26_stock_scraper.py)| "Scrape the S&P 500 Companies list from Wikipedia, then output the data"|
+|27| [send_sms.py](https://github.com/realpython/python-scripts/tree/master/scripts/27_send_sms.py)| "Send SMS message via [TextBelt](http://textbelt.com/)"|
+|28| [income_tax_calculator.py](https://github.com/realpython/python-scripts/tree/master/scripts/28_income_tax_calculator.py)|"Income tax calculator via [Taxee](http://taxee.io/)"|
+|29| [json_to_yaml.py](https://github.com/realpython/python-scripts/tree/master/scripts/29_json_to_yaml.py)| "Convert JSON to YAML"|
+|30| [fullcontact.py](https://github.com/realpython/python-scripts/tree/master/scripts/30_fullcontact.py)| "Call the [FullcContact](https://www.fullcontact.com/developer/) API"|
+|31| [youtube_sentiment.py](https://github.com/realpython/python-scripts/tree/master/scripts/31_youtube_sentiment.py)| "Calculate sentiment score from the comments of a Youtube video"|
+|32| [stock_scraper.py](https://github.com/realpython/python-scripts/tree/master/scripts/32_stock_scraper.py)| "Get stock prices"|
+|33| [country_code.py](https://github.com/realpython/python-scripts/tree/master/scripts/33_country_code.py)|"Convert country code to country name"|
+|34| [git_all_repos.py](https://github.com/realpython/python-scripts/tree/master/scripts/34_git_all_repos.py)|" Clone all repositories from a public user or organization on Github. Usage: `python git_all_repos.py users USER_NAME` or `python git_all_repos.py orgs ORG_NAME`"|