fleshing out a couple of docs