Lady’s Gitweb - Vocab/blob - data/annotation_properties/vocabstatus¦term_status

   1 <?xml version="1.0"?>
   2 <!--
   3 SPDX-FileCopyrightText: 2024 Lady <https://www.ladys.computer/about/#lady>
   4 SPDX-License-Identifier: CC0-1.0
   5 -->
   6 <!DOCTYPE AnnotationProperty SYSTEM "../../DTD">
   7 <AnnotationProperty>
   8         <label xml:lang="en">has status</label>
   9         <comment xml:lang="en">
  10                 <p>
  11                         A <resource name="xsd:string"/> which indicates the status.
  12                 </p>
  13                 <p>
  14                         <ptr target="(VOCAB-STATUS)"/> notes that this property might “more properly” have been modelled as taking I·R·I¦s, perhaps of instances of a “vocab status” class, but it uses one of a small handful of string values instead.
  15                         As it is an annotation property (and not able to be reasoned about regardless), the use of strings is not practically problematic.
  16                 </p>
  17                 <p>
  18                         Four values have broad usage :⁠—
  19                 </p>
  20                 <list>
  21                         <item>
  22                                 <p>
  23                                         <value datatype="xsd:string">unstable</value> indicates that the usage and documentation for a thing are liable to change arbitrarily in the future.
  24                                 </p>
  25                         </item>
  26                         <item>
  27                                 <p>
  28                                         <value datatype="xsd:string">testing</value> indicates that the usage and documentation for a thing are fairly settled, but may still change with implementation experience or due to unanticipated factors.
  29                                 </p>
  30                         </item>
  31                         <item>
  32                                 <p>
  33                                         <value datatype="xsd:string">stable</value> indicates that the usage and documentation for a thing is settled and not expected to change drastically.
  34                                 </p>
  35                         </item>
  36                         <item>
  37                                 <p>
  38                                         <value datatype="xsd:string">archaic</value> indicates that a term is not considered bestpractice anymore and the use of other terms, when possible, is preferable.
  39                                 </p>
  40                         </item>
  41                 </list>
  42                 <p>
  43                         This ontology also makes use of a fifth value, <value datatype="xsd:string">plumbing</value>, which indicates that a term exists only for the purposes of ontology definition or clarity of explanation.
  44                         Plumbing terms should be considered especially unstable and making direct use of them is discouraged.
  45                 </p>
  46         </comment>
  47         <isDefinedBy>
  48                 <SpecificResource source="(VOCAB-STATUS)"/>
  49         </isDefinedBy>
  50         <range>
  51                 <resource name="xsd:string"/>
  52         </range>
  53 </AnnotationProperty>