diff --git a/README.md b/README.md
index 693f3e40a..db72cafa3 100644
--- a/README.md
+++ b/README.md
@@ -70,6 +70,8 @@ defendants.chesscom -> hans: 72 page report of cheating
 
 <img src="./docs/assets/syntax.png" alt="D2 render example" />
 
+> Rendered with the TALA layout engine.
+
 > For more examples, see [./docs/examples](./docs/examples).
 
 ## Quickstart
diff --git a/d2themes/README.md b/d2themes/README.md
index 3825d9c0f..dd9425e22 100644
--- a/d2themes/README.md
+++ b/d2themes/README.md
@@ -3,6 +3,15 @@
 `d2themes` defines themes for D2. You can add a new one in `./d2themescatalog`, give a
 unique ID, and specify it in the CLI or library to see it.
 
+For example, to use the "Shirley temple" theme, which has an ID of 102:
+
+```sh
+d2 --theme 102 --watch example-twitter.d2 out-twitter.svg
+```
+
+Run `d2 --help` or `man d2` for more.
+
+
 # Themes overview
 
 <img src="../docs/assets/themes_overview.png" />