diff --git a/README.md b/README.md
index 632c8aa..0a42d36 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,11 @@
-# olib
\ No newline at end of file
+# olib
+
+## `olib.debug()`
+
+```
+from olib import olib
+
+@olib.debug(True)
+def some_function(n):
+  # do something
+```