add some documentation and bump to 1.0.0