diff --git a/docs/nomenclature.md b/docs/nomenclature.md
new file mode 100644
index 0000000..381e5c9
--- /dev/null
+++ b/docs/nomenclature.md
@@ -0,0 +1,4 @@
+We use `Call` and `Result` for our own types that wrap `Request` and
+`Response`.
+
+This hopefully will make things less confusing and avoid problems with shadowing.