final state of files, revert travis.yml and add comments, examples