fleshing out the docs, more