diff --git a/README.md b/README.md
index 8f47f11..a7c134e 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,30 @@ No configuration needed, install and forget.
 
 ---
 
+### Log Sessions
+
+Organizes the combat, raw combat, and chat logs into per-character directories with timestamped filenames:
+
+```
+Logs\<Realm>\<Character>\WoWChatLog_YYYYMMDD_HHMMSS.txt
+Logs\<Realm>\<Character>\WoWCombatLog_YYYYMMDD_HHMMSS.txt
+Logs\<Realm>\<Character>\WoWRawCombatLog_YYYYMMDD_HHMMSS.txt (superwow only)
+```
+
+Every character login begins with a marker line (`COMBATLOG_SESSION` or `CHAT_SESSION`) identifying the character and realm.
+If a log file for the same character was written to within the last 60 minutes, the same logfile will be used instead of creating a new one.
+
+Lua API for addon developers:
+
+- `GetCombatLogPath()` -- returns the current combat log file path
+- `GetChatLogPath()` -- returns the current chat log file path
+
+No other configuration needed, install and forget.
+
+**DLL:** `logsessions.dll`
+
+---
+
 ### SuperWoW Heal Text Fix
 
 Fixes duplicate floating heal numbers caused by SuperWoW 1.5. Only relevant if you use SuperWoW. No configuration needed, install and forget.