This is just to get some agreement on the sort of documentation content we are expecting. Related to #1215.