From: Lady <redacted>
Date: Wed, 1 Jan 2025 19:54:12 +0000 (-0500)
Subject: Improve document modelling
X-Git-Url: https://git.ladys.computer/Vocab/commitdiff_plain/1e095be9012c0fa845c88625ac1c97398076450e?hp=975edf97a4ea24d6905a1198c9bc829e6631ca3a

Improve document modelling

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

diff --git "a/data/classes/foaf\302\246Image" "b/data/classes/foaf\302\246Image"
index 827500f..7311884 100644
--- "a/data/classes/foaf\302\246Image"
+++ "b/data/classes/foaf\302\246Image"
@@ -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,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\302\246body" "b/data/datatype_properties/awol\302\246body"
index dbae65a..260ef5f 100644
--- "a/data/datatype_properties/awol\302\246body"
+++ "b/data/datatype_properties/awol\302\246body"
@@ -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 DatatypeProperty SYSTEM "../../DTD">
@@ -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\302\246src" "b/data/object_properties/awol\302\246src"
index c2ac17d..8981c1f 100644
--- "a/data/object_properties/awol\302\246src"
+++ "b/data/object_properties/awol\302\246src"
@@ -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 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>
-			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\302\246topic" "b/data/object_properties/foaf\302\246topic"
index 6e86470..9a9685e 100644
--- "a/data/object_properties/foaf\302\246topic"
+++ "b/data/object_properties/foaf\302\246topic"
@@ -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 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>
+			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"/>