refs #283, this edit adds information but does not help the flow.  More editing is needed, as indicated in the file overview.rst
refs #283, could be better, stopping here for now