Docs cleanup

[aaron-skydio]

Make a pass over the docs to clean them up.

Components:

• Update everything to current best practices and APIs
• Add cross-references
• Make sure things are formatted nicely
• Make sure all doc comments in the code show up

[aaron-skydio]

Generally marking this as resolved with the recent changes now merged to main, will create new issues for other specific changes