diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -1,3 +1,17 @@
 # Graflog
 
 Monadic correlated log events!
+
+##To Use:
+
+- you must force stdout to flush after each line, or logs won't appear in a timely manner: call `Graflog.Console.enableStdoutLineBuffering` at the top of your main function.
+
+- CorrelationId and EventId generation are not yet supported, so you must create an event manually:
+  - inside do notation: `let event = Event (CorrelationId 0) (EventId 0)`
+  - followed at some point by: `logJSON $ event (Action "some kind of metadata") (toLog dataToLog)`
+
+##To Do:
+
+- CorrelationId and EventId generation
+- Generic derivation of ToLog / ToJSON instances
+- Support for non-JSON logging?
diff --git a/graflog.cabal b/graflog.cabal
--- a/graflog.cabal
+++ b/graflog.cabal
@@ -1,5 +1,5 @@
 name:                graflog
-version:             6.1.0
+version:             6.1.1
 synopsis:            Monadic correlated log events
 description:         Please see README.md
 homepage:            https://github.com/m-arnold/graflog#readme