update

docblocks review mostly