new conventions documentation and some additional files.