diff --git a/README.md b/README.md
index 98b91c3..17c789c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,8 @@
 # MyNib
 **MyNib (My Nix Library)** is a mini lil library of utilities I find
 myself frequently rewriting.
+
+
+## Conventions
+1. "private" attribute set values: start and end with underscores, ie `MyType._value_`
+2. Modules: use the `useMod` and `mkMod` nib provides