review of requirements doc, minor cleanups