arcade
arcade copied to clipboard
Improve typing and doc for physics engines
A follow-up to #1973 after reading through it.
Changes
- [x] Add missing type hints to physics engines
- [x] Rewrite existing docstrings for clarity
- [x] Fix style and clarity issues in code
- [x] Add comments to clarify actions in some places
- [ ] Fix copy and pasted docstring comments in pymunk physics engine docstrings
Why
The physics engines are part of the most popular tutorial users interact with. Their doc and type annotations should live up to that to improve first-timer experience.
Not actually good to go in its current state, but GitHub's maintainer ergonomics on drafts are bad.
Superceded by #2185