reanming some files, adding commentary to code examples