better documented files for release