Improve document modelling

…primarily by not requiring that everything be a `foaf:Document`.

diff --git a/data/classes/foaf¦Image b/data/classes/foaf¦Image
index 827500f4eb9d485616599a41ef3eb33f3f5082fb..7311884110621f3b54d504465d55be4fca1c4de7 100644 (file)
--- a/data/classes/foaf¦Image
+++ b/data/classes/foaf¦Image
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
 <?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">
 SPDX-License-Identifier: CC0-1.0
 -->
 <!DOCTYPE Class SYSTEM "../../DTD">


@@ -8,10 +8,14 @@ SPDX-License-Identifier: CC0-1.0
        <label xml:lang="en">Image</label>
        <comment xml:lang="en">
                <p>
        <label xml:lang="en">Image</label>
        <comment xml:lang="en">
                <p>

-                       A <ref target="foaf:Document">Document</ref> which is conveyed as a (still?) image.
+                       A <ref target="foaf:Document">Document</ref> which has a primarily static, visual rendering intent.

                </p>
                <p>
                </p>
                <p>

-                       This class is <em>not</em> equated with <ptr target="dcmitype:StillImage"/> because it <em>can</em> encompass images of text, where·as the latter <em>should not</em>.
+                       “Primarily static”, in this definition, implies only that the Document is not intended to show the passage of time, as a video would.
+                       Allowances can be made for atemporal motion.
+               </p>
+               <p>
+                       This class is <em>not</em> equated with <ptr target="dcmitype:StillImage"/> because it <em>can</em> encompass “images” of text, where·as the latter <em>should not</em>.

                        This leaves open the question of what exactly constitutes an “image” in the physical world, but thankfully this class is mostly only ever used for digital images.
                </p>
        </comment>
                        This leaves open the question of what exactly constitutes an “image” in the physical world, but thankfully this class is mostly only ever used for digital images.
                </p>
        </comment>

diff --git a/data/datatype_properties/awol¦body b/data/datatype_properties/awol¦body
index dbae65a838e81e0bd50686b34dfdc2669f15d118..260ef5fd60b372d0d89de6e9376c3eb4c4db43f5 100644 (file)
--- a/data/datatype_properties/awol¦body
+++ b/data/datatype_properties/awol¦body
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
 <?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 DatatypeProperty SYSTEM "../../DTD">
 SPDX-License-Identifier: CC0-1.0
 -->
 <!DOCTYPE DatatypeProperty SYSTEM "../../DTD">


@@ -24,7 +24,6 @@ SPDX-License-Identifier: CC0-1.0
        <domain>
                <Class>
                        <intersectionOf>
        <domain>
                <Class>
                        <intersectionOf>

-                               <resource name="foaf:Document"/>

                                <resource name="awol:Content"/>
                                <Restriction>
                                        <onProperty>
                                <resource name="awol:Content"/>
                                <Restriction>
                                        <onProperty>

diff --git a/data/object_properties/awol¦src b/data/object_properties/awol¦src
index c2ac17df9dcd81d0cc03945f4428df5fc90e365b..8981c1feb49d96952716d2eb46b0bb818aac8453 100644 (file)
--- a/data/object_properties/awol¦src
+++ b/data/object_properties/awol¦src
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
 <?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 ObjectProperty SYSTEM "../../DTD">
 SPDX-License-Identifier: CC0-1.0
 -->
 <!DOCTYPE ObjectProperty SYSTEM "../../DTD">


@@ -8,7 +8,7 @@ SPDX-License-Identifier: CC0-1.0
        <label xml:lang="en">has source</label>
        <comment xml:lang="en">
                <p>
        <label xml:lang="en">has source</label>
        <comment xml:lang="en">
                <p>

-                       The <ref target="foaf:Document">Document</ref> which provides the body of this <ref target="awol:Content">Content</ref>.
+                       The thing which provides the body of this <ref target="awol:Content">Content</ref>.

                </p>
        </comment>
        <isDefinedBy>
                </p>
        </comment>
        <isDefinedBy>


@@ -17,7 +17,4 @@ SPDX-License-Identifier: CC0-1.0
        <domain>
                <resource name="awol:Content"/>
        </domain>
        <domain>
                <resource name="awol:Content"/>
        </domain>

-       <range>
-               <resource name="foaf:Document"/>
-       </range>

 </ObjectProperty>
 </ObjectProperty>

diff --git a/data/object_properties/foaf¦topic b/data/object_properties/foaf¦topic
index 6e864709da690806f07c78bc56989eedc74ffff4..9a9685ec435a05cf02784c78062dc9808297c25c 100644 (file)
--- a/data/object_properties/foaf¦topic
+++ b/data/object_properties/foaf¦topic
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
 <?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 ObjectProperty SYSTEM "../../DTD">
 SPDX-License-Identifier: CC0-1.0
 -->
 <!DOCTYPE ObjectProperty SYSTEM "../../DTD">


@@ -10,6 +10,10 @@ SPDX-License-Identifier: CC0-1.0
                <p>
                        A thing that this <ref target="foaf:Document">Document</ref> is about.
                </p>
                <p>
                        A thing that this <ref target="foaf:Document">Document</ref> is about.
                </p>

+               <p>
+                       Note that this property primarily exists as an inverse of <ptr target="foaf:page"/>, and consequently has a domain of Documents.
+                       For a more general term which can encompass parts or collections of Documents, use <ptr target="dcterms:subject"/>
+               </p>

        </comment>
        <isDefinedBy>
                <SpecificResource source="(FOAF)" fragment="term_topic"/>
        </comment>
        <isDefinedBy>
                <SpecificResource source="(FOAF)" fragment="term_topic"/>