random notes

you might find some of the README text useful, or perhaps not. also, a few random inline notes from a fast reading. Please close the req after reading or ignoring, you don't need to do anything with it, of course.