docs(*): doc edits for stable release
Merge pull request #2456 from gabrtv/doc-review

Update documentation in preparation for stable release