doc generation in build script and readme explanation