added commentary on classes/functions which needed it