Add missing Atom link relation terms

[Vocab] / data / classes / anno¦Annotation

diff --git a/data/classes/anno¦Annotation b/data/classes/anno¦Annotation
index a4ac7b0b959f1888aef6a87b2fa4fa978c2d04a3..5e387f4363846053ee08f4291efb0014764abc40 100644 (file)
--- a/data/classes/anno¦Annotation
+++ b/data/classes/anno¦Annotation
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
-SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
+SPDX-FileCopyrightText: 2024, 2025 Lady <https://www.ladys.computer/about/#lady>
 SPDX-License-Identifier: CC0-1.0
 -->
 <!DOCTYPE Class SYSTEM "../../DTD">
@@ -8,7 +8,7 @@ SPDX-License-Identifier: CC0-1.0
        <label xml:lang="en">Annotation</label>
        <comment xml:lang="en">
                <p>
-                       A usually‐purposeful association of bodies and·or <ref target="anno:Motivation">Motivations</ref> with another thing.
+                       An <ref target="sioc:Item">Item</ref> consisting of a usually‐purposeful association of bodies and·or <ref target="anno:Motivation">Motivations</ref> with another thing.
                </p>
                <p>
                        Annotations, in their most common uses, link resources to other resources, with the resources being linked from provided as their <ref target="anno:hasBody">bodies</ref> and the resources being linked to provided as their <ref target="anno:hasTarget">targets</ref>.
@@ -16,12 +16,20 @@ SPDX-License-Identifier: CC0-1.0
                        When an Annotation is motivated by a Motivation, bodies might not be present (if the Motivation provides all the necessary information itself).
                </p>
                <p>
-                       Despite the name, it¦s important to understand that an Annotation is essentially just a motivated collection of links, and this class may be used anywhere a motivated collection of links is desired.
+                       It is important to understand that Annotations are, themselves, resources, independent of their bodies:
+                       Annotations and their bodies might have different <ref target="dc:creator">creators</ref> and might be created on different days.
+                       An Annotation motivated by <ref target="anno:replying">Replying</ref> does not imply that its body is <ref target="sioc:reply_to">in reply to</ref> its target (but rather that the <em>creator</em> of the Annotation is using its body to reply).
+               </p>
+               <p>
+                       Despite the name, and the above caveats aside, an Annotation is essentially just a motivated collection of links, and this class may be used anywhere a motivated collection of links is desired.
                </p>
        </comment>
        <isDefinedBy>
                <SpecificResource source="(ANNO)" fragment="annotation"/>
        </isDefinedBy>
+       <subClassOf>
+               <resource name="sioc:Item"/>
+       </subClassOf>
        <subClassOf>
                <Restriction>
                        <onProperty>