more docs, a few comments