doc: Rework docs to align with Rust and other libs

[crandmck]

The main purpose of this PR is to streamline the main README file and move some of the content from there into new files in the docs directory, similar to restructuring I'm doing in other repos:

• Usage
• Release notes
• Project contributions

Because the existing docs directory contains the generated API docs, I renamed that dir to api-docs and updated the script command in package.json. Unfortunately, re-running the script apparently touched ALL the generated API doc .md files, making this PR much bigger than anticipated.

@tmathern I'm not sure if that's a problem...LMK if you want me to try to find a way to avoid this side-effect.

[changeset-bot]

⚠️ No Changeset found

Latest commit: cfec12f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[tmathern]

I think it's intended to re-generate the docs. It doesn't have the smarts yet to look if there was a real underlying change or not.