apply latest changes in README to overview.edoc

The overview is used to build the readme so apply changes to it and
regen the doc.