Fixed pkglint warnings.
- added type definitions for two variables
- improved wording of some warnings
- added explanations to some common warnings
patch for chavier in pycha