diff --git a/README.md b/README.md
index eb92327..2dec7b1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,63 @@
 # DEVONthink
 
-Code for various AppleScripts I've written or modified for DEVONthink Pro 3
\ No newline at end of file
+Code for various AppleScripts I've written or modified for DEVONthink Pro 3
+
+## 🔗 Bates Source Link - Citation Generator
+
+Creates formatted citations from DEVONthink documents, with smart Bates number support.
+
+## Usage
+
+1. Open document in DEVONthink
+2. Select text to quote
+3. Run script
+4. Paste formatted citation
+
+## Output Examples
+
+Bates-numbered documents:
+```markdown
+"The environmental impact study shows..." [FWS 123456](x-devonthink-item://...)
+```
+
+Regular documents:
+```markdown
+"The data indicates..." [Report Title at 5](x-devonthink-item://...)
+```
+
+## Features
+
+- Smart Bates number detection and formatting
+- Page number tracking
+- URL-encoded quotes
+- Markdown-compatible output
+- Error handling
+- Works with both Bates and regular documents
+
+## Installation
+
+1. Open DEVONthink
+2. Go to Scripts menu
+3. Select "Open Scripts Folder"
+4. Add script to folder
+
+## Keyboard Shortcut (Optional)
+
+1. System Settings → Keyboard → Keyboard Shortcuts
+2. Select "App Shortcuts" → "+"
+3. Choose DEVONthink
+4. Enter exact script name
+5. Assign desired shortcut
+
+## Requirements
+
+- DEVONthink Pro
+- macOS
+- Perl (for URL encoding)
+
+## Notes
+
+- Works best with consistent Bates number formatting
+- Creates markdown-compatible citations
+- Copies result to clipboard
+- Perfect for legal research and document analysis
\ No newline at end of file