improved documentation. increment version to 1.0.0, because I think it is now stable.