Enh: improved class descriptions in comments
Enh: improved comments for Firm class methods