Update API docs

[Widcket]

• [ ] All new/changed/fixed functionality is covered by tests (or N/A)
• [ ] I have added documentation for all new/changed functionality (or N/A)

📋 Changes

This PR updates the API docs, and also updates a couple of lines in two Markdown docs.