documentation:

- documentation update for clarity
- bump package

Impact: low