add more commentary to these files