diff --git a/HowToWriteTests.md b/HowToWriteTests.md
new file mode 100644
index 0000000..4cab9d7
--- /dev/null
+++ b/HowToWriteTests.md
@@ -0,0 +1,10 @@
+Choose a name for your test file. We'll use `test_fname.py`:
+
+```
+touch src/allmydata/test/test_fname.py
+```
+
+```
+./bin/tahoe debug trial allmydata.test.test_fname
+```
+