Clarify linkRef/roleMembershipRef documentation

Meaning of these references is slightly moving as we introduced Linked Object feature and its terminology. A part of MID-6109 implementation.
Evolveum · Jun 12, 2020 · cce6de6 · cce6de6
1 parent 005ef8e
commit cce6de6
Showing 1 changed file with 11 additions and 1 deletion.
diff --git a/infra/schema/src/main/resources/xml/ns/public/common/common-core-3.xsd b/infra/schema/src/main/resources/xml/ns/public/common/common-core-3.xsd
@@ -4345,7 +4345,7 @@
                                 </p>
                                 <p>
                                 Assignments represent what the object SHOULD HAVE. The assignments represent a policy,
-                                a desired state of things (cf. linkRef).
+                                a desired state of things (cf. linkRef, roleMembershipRef).
                                 </p>
                             </xsd:documentation>
                             <xsd:appinfo>
@@ -4427,6 +4427,11 @@
                                   for efficient search of all current role members, e.g. for the purpose of displaying this
                                   information in the GUI.
                                 </p>
+                                <p>
+                                    Note: roleMembershipRef will be probably renamed to something like linkRef or
+                                    outboundLinkRef. We need to generalize it to contain information on generic links
+                                    between objects (e.g. between child and its parents).
+                                </p>
                             </xsd:documentation>
                             <xsd:appinfo>
                                 <a:objectReferenceTargetType>tns:AbstractRoleType</a:objectReferenceTargetType>
@@ -4526,6 +4531,11 @@
                                 Links define what the object HAS. The links reflect real state of things
                                 (cf. assignment).
                                 </p>
+                                <p>
+                                    Note: linkRef will be probably renamed to projectionRef or projectionLinkRef.
+                                    There are more kinds of links between objects than focus - projection links
+                                    (cf. roleMembershipRef).
+                                </p>
                             </xsd:documentation>
                             <xsd:appinfo>
                                 <a:displayName>FocusType.linkRef</a:displayName>