add comment explaining why diag is not always visible