some doc comments
some more doc comments
the last run of doc comments before 1.0.0
version bump: I feel this is now ready to be called 1.0.0