1 files changed, 17 insertions, 0 deletions
diff --git a/README.md b/README.md
index 3562dcf..2f07250 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,18 @@
+[![Build Status](https://travis-ci.org/felix/lexer.svg)](https://travis-ci.org/felix/lexer)
+[![GoDoc](https://godoc.org/github.com/felix/lexer?status.svg)](http://godoc.org/github.com/felix/lexer)
+[![Go Report Card](https://goreportcard.com/badge/github.com/felix/lexer)](https://goreportcard.com/report/github.com/felix/lexer)
+
 # Generic Go lexer
+
+A very simple lexer.
+
+```go
+import "github.com/felix/lexer"
+```
+
+or
+
+```go
+import "src.userspace.com.au/felix/lexer"
+```
+