fleshing out the docs