adding some documentation to these files, more to come