fleshing out blank spots in docs