tweak html gen, add functionality & implementation summaries to the README