Update documentation on typings

[Darylgolden]

Enhancement proposal

Our docs on typings is outdated and does not reflect best practices and consensus on how typings should be added to the codebase.

Additional comments

[behackl]

Has been reworked with the introduction of the typing module. Still incomplete, but at least no longer out of date. Closing this.