The documentation should motivate its use. For example, mention F1 scoring with a minority positive class.