diff --git a/bitten/README.md b/bitten/README.md
index 75b0a52..c4264b8 100644
--- a/bitten/README.md
+++ b/bitten/README.md
@@ -1 +1,3 @@
 interface with biteopt through a function decorator.
+
+this still needs documentation, but `test_b2.py` is a good place to get started.