provide the most comprehensive documentation feasible

within the current constraints etc