Improved documentation of Societe and started type hinting variables