Improve document modelling

[Vocab] / data / classes / contact¦SocialEntity

diff --git a/data/classes/contact¦SocialEntity b/data/classes/contact¦SocialEntity
index 290df58087091222e8d6bfb7006e3120ef3678b5..2bff655e6f309a352ac7838c7c8c0d2c6c9adcd3 100644 (file)
--- a/data/classes/contact¦SocialEntity
+++ b/data/classes/contact¦SocialEntity
@@ -13,9 +13,11 @@ SPDX-License-Identifier: CC0-1.0
                <p>
                        This class is intended as a broad category for people, organizations, and other entities which might be addressed in a social context, for example over the phone or via post.
                        The emphasis on sociality distinguishes this class from that of <ref target="foaf:Agent">Agents</ref>, which are defined based on their ability to perform actions.
+                       (Many Social Entities are also Agents, but many may not be—for example, <ref target="foaf:OnlineAccount">Online Accounts</ref> are <em>used by</em> Agents rather than being Agents themselves.
+                       Nevertheless, Online Accounts may be addressed and sent messages.)
                </p>
                <p>
-                       Despite the above definitions, phone numbers in <ptr target="(SWAP-PIM)"/> are actually generally conceived as properties of <ref target="contact:ContactLocation">Contact Points</ref>.
+                       Despite the above definitions, phone numbers in <ptr target="(SWAP-PIM)"/> are actually generally conceived as properties of <ref target="contact:ContactLocation">Contact Points</ref> rather than Social Entities proper.
                </p>
        </comment>
        <isDefinedBy>