more comprehensive docs

Tasks
- [ ] Will likely need to be updated due to upcoming class name changes