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..e9121ed418abd07854cf34312671d2f9646eed0c 100644 (file)
--- a/data/classes/foaf¦Image
+++ b/data/classes/foaf¦Image
@@ -8,10 +8,14 @@ SPDX-License-Identifier: CC0-1.0
        <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>
-                       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>

diff --git a/data/datatype_properties/awol¦body b/data/datatype_properties/awol¦body
index dbae65a838e81e0bd50686b34dfdc2669f15d118..3dc8f2861107d6e8604fc92fcad17c4c0d4432e2 100644 (file)
--- a/data/datatype_properties/awol¦body
+++ b/data/datatype_properties/awol¦body
@@ -24,7 +24,6 @@ SPDX-License-Identifier: CC0-1.0
        <domain>
                <Class>
                        <intersectionOf>
-                               <resource name="foaf:Document"/>
                                <resource name="awol:Content"/>
                                <Restriction>
                                        <onProperty>

diff --git a/data/object_properties/awol¦src b/data/object_properties/awol¦src
index c2ac17df9dcd81d0cc03945f4428df5fc90e365b..bace0bdb3dd641b0ccf316e0a994374a20ed496b 100644 (file)
--- a/data/object_properties/awol¦src
+++ b/data/object_properties/awol¦src
@@ -8,7 +8,7 @@ SPDX-License-Identifier: CC0-1.0
        <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>
@@ -17,7 +17,4 @@ SPDX-License-Identifier: CC0-1.0
        <domain>
                <resource name="awol:Content"/>
        </domain>
-       <range>
-               <resource name="foaf:Document"/>
-       </range>
 </ObjectProperty>

diff --git a/data/object_properties/foaf¦topic b/data/object_properties/foaf¦topic
index 6e864709da690806f07c78bc56989eedc74ffff4..ed173c44fa5bf16464e0142054de1721b7da7083 100644 (file)
--- a/data/object_properties/foaf¦topic
+++ b/data/object_properties/foaf¦topic
@@ -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>
+                       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"/>