Improving documentation of Societe class

Improving documentation of Societe class