add some more inline docs