@nedbat the README is to give enough context to reviewers so that they can effectively review the code. Effort spent writing anything beyond that is probably better left for the chapter.