+1
There’s a wrinkle here, however. The type specs are Python, but how they are used/interpreted is up to third party packages.
So it’s a bit tricky to know exactly what to document where.
I don’t think that’s insurmountable, but something to keep in mind.
For example, while the clear specs are the first step, what the community really could use is a good “recommended practices for static typing” doc — and that’s harder to do without reference to particular tools.
-CHB
--
Christopher Barker, PhD (Chris)
Python Language Consulting
- Teaching
- Scientific Software Development
- Desktop GUI and Web Development
- wxPython, numpy, scipy, Cython