REV: add comments
w/ ned's review comments