DOC: updated readme

@yawnt I think it is good to go. If you have any other tests in mind let me know.