while we're on the topic of documentation