diff --git a/README.md b/README.md
index a74dd75..7b060ab 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,20 @@ Tool for standardizing Partisia's Java tests.
 Is capable of migrating from Javadoc based property specification to the
 `@DisplayName` specification and back.
 
+## Usage
+
+Convert tests with `@DisplayName` to Javadoc:
+
+```bash
+python -m standardize_java_text --javadoc --only-displayname FILE...
+```
+
+It it recommended that you do this with no unstaged changes, to more easily
+verify the result.
+
+You may need to call your formatting tool afterwards, as the converter doesn't
+take formatting into account.
+
 ## Dependencies
 
 This project does not have any dependencies 😎
diff --git a/setup.py b/setup.py
index 01af23a..36e6af8 100644
--- a/setup.py
+++ b/setup.py
@@ -17,6 +17,20 @@ Tool for standardizing Partisia's Java tests.
 
 Is capable of migrating from Javadoc based property specification to the
 `@DisplayName` specification and back.
+
+## Usage
+
+Convert tests with `@DisplayName` to Javadoc:
+
+```bash
+python -m standardize_java_text --javadoc --only-displayname FILE...
+```
+
+It it recommended that you do this with no unstaged changes, to more easily
+verify the result.
+
+You may need to call your formatting tool afterwards, as the converter doesn't
+take formatting into account.
 """.strip()
 
 PACKAGE_DESCRIPTION_SHORT = """