document and refactor some of the various data files