Improved commenting

Improved commenting in the main and populate classes.