document updates and version bump
updated comments