readme tweaks
doc generation tweaks