MNT: Fixed logic in pytype_to_vtsig

- other minor changes to documentation