add summary to README and code comments