diff --git a/requirements-dev.in b/requirements-dev.in
index c726409..56dc652 100644
--- a/requirements-dev.in
+++ b/requirements-dev.in
@@ -1,4 +1,4 @@
 -r requirements.in
 
-pip-tools
-prospector
+pip-tools               # pip-compile on these files
+prospector              # code quality checks
diff --git a/requirements.in b/requirements.in
index 2b687a8..26eb168 100644
--- a/requirements.in
+++ b/requirements.in
@@ -1,5 +1,5 @@
-aiohttp
-discord.py
-Django
-ply
-requests
+aiohttp                 # API server
+discord.py              # discord client
+Django                  # DB backend/management commands
+ply                     # lex and yacc, for the dice module
+requests                # HTTP requests, for the weather module and likely others