doc: overhaul source code docs

- add docstrings to classes that were missing them
- Use docstrings instead of sphinx-style inline comments for class variables
- Improve and fix existing docstrings
- Add Sphinx directives to link to functions/docs
- Mark more variables as Final

Author: GhostofGoes