Add class method documentation, modify comments for readability