fix builder to write the source files
documentation updates