first pass documentation