cleaned up readme, renamed file, added doc.go and moved example to it
slight format fixes
apparently example lives in a _test file. forgotten file
small doc fixes