diff --git a/modules/core/docs/authproc_scopeattribute.txt b/modules/core/docs/authproc_scopeattribute.txt
index 990e926949a0a5f1d388874cf5d700c61b56c43d..6930149bb355cbf4bacf3cc66a39212cc1521c39 100644
--- a/modules/core/docs/authproc_scopeattribute.txt
+++ b/modules/core/docs/authproc_scopeattribute.txt
@@ -2,6 +2,7 @@
 =====================
 
 A filter which combines two attributes into a scoped attribute.
+That is, the value will be `something@scope`, usually to make it globally unique.
 
 Parameters
 ----------
@@ -38,3 +39,6 @@ Add eduPersonScopedAffiliation based on eduPersonAffiliation and eduPersonPrinci
         'targetAttribute' => 'eduPersonScopedAffiliation',
     ),
 
+With values being `eduPersonPrincipalName`: `jdoe@example.edu` and
+`eduPersonAffiliation`: `faculty`, this will result in the attribute
+`eduPersonScopedAffiliation` with value `faculty@example.edu`.