more docs, and fleshing out the views