update readme

1 files changed, 12 insertions, 8 deletions

diff --git a/README.md b/README.md
index 34d2a1f..99f5b83 100644
--- a/README.md
+++ b/README.md
@@ -2,14 +2,18 @@
 
 [![Build Status](https://travis-ci.org/untitaker/rust-vobject.svg?branch=master)](https://travis-ci.org/untitaker/rust-vobject)
 
-This is a primitive unstable vobject parser for Rust, originally written for [a
-simple addressbook script](https://github.com/untitaker/mates.rs) and based on
-[rust-peg](https://github.com/kevinmehall/rust-peg).
+This is a primitive VObject and iCalendar parser for Rust, originally written
+for [a simple addressbook script](https://github.com/untitaker/mates.rs) and
+based on [rust-peg](https://github.com/kevinmehall/rust-peg).
 
-The author hasn't read the relevant RFCs, so this library handles all versions
-of VCard and iCalendar equally badly.
+## Documentation
 
-See the testsuite for some basic usage. This is an experiment by me to learn
-Rust, and the API is too imperfect to be documented. Suggestions are welcome.
+    make docs
 
-It is licensed under the MIT license, see `LICENSE`.
+## Testsuite
+
+    make test
+
+This is an experiment by me to learn Rust, and the API is pretty bad.
+
+It is licensed under MIT, see `LICENSE`.