documentation changes

some changes for the readme. will probably do a blog entry as well with
just a bit more info.