fix spelling
remove a set of old no-longer-relevant notes
Document how the source code is organized (in the README)