diff --git a/youdis.py b/youdis.py
index 87c0f1e..168ce2a 100644
--- a/youdis.py
+++ b/youdis.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+"""Launcher shim for the Discord adapter."""
 
 from youdis.adapters.discord import main
 
diff --git a/youdis/adapters/discord.py b/youdis/adapters/discord.py
index 30823c8..c4ecf11 100644
--- a/youdis/adapters/discord.py
+++ b/youdis/adapters/discord.py
@@ -1,3 +1,5 @@
+"""Discord adapter for interacting with FastAPI backend worker."""
+
 import asyncio
 from os import getenv
 
diff --git a/youdis/main.py b/youdis/main.py
index 8faf8e1..36d99eb 100644
--- a/youdis/main.py
+++ b/youdis/main.py
@@ -1,3 +1,5 @@
+"""FastAPI backend worker managing yt-dlp subprocess jobs and exposing job state."""
+
 import asyncio
 from asyncio.subprocess import PIPE, STDOUT
 from collections import deque