diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3a6e672
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+goutmp - Minimal bindings to C stdlib pututmpx(), getutmpx() (/var/log/wtmp) and /var/log/lastlog
+
+Any Go program which allows user shell access should update the standard UNIX files which track user sessions: /var/log/wtmp (for the 'w' and 'who' commands), and /var/log/lastlog (the 'last' and 'lastlog' commands).
+
+go doc
+package goutmp // import "blitter.com/go/goutmp"
+
+Golang bindings for basic login/utmp accounting
+
+func Put_lastlog_entry(app string, usr string, host string)
+func Unput_utmp(entry UtmpEntry)
+type UtmpEntry struct{ ... }
+    func Put_utmp(user string, host string) UtmpEntry
+