todo's readme and new tool
docs, tools and fixxes