improved code book and readme markdown