chore: update documentation and deps

[andrejsharapov]

What is the purpose of this pull request?

• [ ] New Feature
• [ ] Bug fix
• [ ] Breaking change
• [x] Documentation update
• [x] Other

Description

fixes #233 fixes #235

Additional context

---

Before submitting the PR, please make sure you do the following

• [x] Read the Contributing Guidelines and follow the Commit Convention.
• [x] Check that there isn't already a PR that solves the problem the same way to avoid creating a duplicate.
• [x] Provide a description in this PR that addresses what the PR is solving, or reference the issue that it solves (e.g. fixes #yyy).