Docs refresh (work-in-progress)

Why did you decide to move this part after the comments? My own thinking had been that putting the citation information up front is worth it, since we want to make sure people know what to cite.