diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5811afb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# go-httpaccess
+
+Package **httpaccess** implements tools to deal with the HTTP "Accept" header.
+
+## Documention
+
+Online documentation, which includes examples, can be found at: http://godoc.org/github.com/reiver/go-httpaccess
+
+[![GoDoc](https://godoc.org/github.com/reiver/go-httpaccess?status.svg)](https://godoc.org/github.com/reiver/go-httpaccess)
+
+## Example
+```go
+//
+values := httprequest.Values("Accept")
+
+// ...
+
+accept, err := httpaccess.Parse(values...)
+
+// ...
+
+mediatype, err := accept.Negotiate("text/gemini", "text/html", "application/xhtml+xml")
+```