Next version (version 1.0.2)

README.md

@@ -6,14 +6,16 @@ This is the public GitHub repository that holds the source files on RiC-O OWL on
 
 **ICA RiC-O (Records in Contexts-Ontology) is an OWL 2 ontology for describing archival record resources**. As the third part of Records in Contexts (RiC) standard, it is a formal representation of Records in Contexts Conceptual Model (RiC-CM).
 
-The **latest public release of RiC-O, RiC-O 1.0.1, dated May 2024, is now available.** It was released a few weeks after the first stable and complete version of this ontology, thus a major milestone, **RiC-O 1.0**. Apart from slightly modifying or updating a few details in the introduction and fixing a few typos in the documentation of RiC-O 1.0, version 1.0.1 only brings one change: it fixes the IRI of 'hasOrHadSomeMemberswithDocumentaryFormType' object property (changed to 'rico:hasOrHadSomeMembersWithDocumentaryFormType'). It is **fully compliant with RiC-CM 1.0**, which is available in the corresponding repository [https://github.com/ICA-EGAD/RiC-CM](https://github.com/ICA-EGAD/RiC-CM).
+The **latest public release of RiC-O, RiC-O 1.0.2, dated September 2024, is now available.** Version 1.0.2 follows the release of RiC-O 1.0.1, dated May 2024, and the release of the first stable and complete version of this ontology, thus a major milestone, **RiC-O 1.0**. Version 1.0.1 modified a few details in the introduction, fixed a few typos in the documentation of RiC-O 1.0, and brought one change only, fixing the IRI of 'hasOrHadSomeMemberswithDocumentaryFormType' object property (changed to [rico:hasOrHadSomeMembersWithDocumentaryFormType](https://www.ica.org/standards/RiC/ontology#rico:hasOrHadSomeMembersWithDocumentaryFormType)). **Version 1.0.2 fixes an inconsistency bug in RiC-O 1.0, removing global reflexivity from the 48 rolification object properties. It also fixes the French labels of six object properties. Finally, a version IRI (owl:versionIRI) has been added to this 1.0.2 version**, in order to make RiC-O fully compliant with the OWL 2 specification as concerns ontology documents.
+
+RiC-O 1.0.2 is **fully compliant with RiC-CM 1.0**, which is available in the corresponding repository [https://github.com/ICA-EGAD/RiC-CM](https://github.com/ICA-EGAD/RiC-CM).
 
-The OWL/RDF file of RiC-O 1.0.1 is stored in the [ontology/current-version](./ontology/current-version) folder of this repository, with accompanying material, including a HTML version provided for human readers.
+The OWL/RDF file of RiC-O 1.0.2 is stored in the [ontology/current-version](./ontology/current-version) folder of this repository, with accompanying material, including a HTML version provided for human readers.
 The repository also contains other resources, among which examples and diagrams.
 
-**RiC-O 1.0.1 is also accessible to humans and machines through its IRI, [https://www.ica.org/standards/RiC/ontology](https://www.ica.org/standards/RiC/ontology)**.
+**RiC-O 1.0.2 is also accessible to humans and machines through its IRI, [https://www.ica.org/standards/RiC/ontology](https://www.ica.org/standards/RiC/ontology)**.
 
-**You can easily download the whole content of this repository using the latest release.
+You can easily download the whole content of this repository using the latest release.
 
 
 **If you want to contact us, or send comments and questions, you can use the new [Records in Contexts users Google group](https://groups.google.com/g/Records_in_Contexts_users)**.

diagrams/Readme.md

@@ -1,7 +1,7 @@
 # Diagrams
 
 This is where you will find some diagrams that show some of the components of the RiC-O, for each version of RiC-O.
-For now, as concerns RiC 1.0.1, you will just find there one diagram which provides a global overview of RiC-CM 1.0 entities and also shows a few relations.
+For now, as concerns RiC 1.0.2, you will just find there one diagram which provides a global overview of RiC-CM 1.0 entities and also shows a few relations.
 
 The diagrams may, either display a part of RiC ontology itself, or illustrate how you can represent some real world cases using RiC-O. 
 

docs/Readme.md

@@ -14,15 +14,15 @@
 
 
 
-This website was last updated on May 13<sup>th</sup>, 2024.
+This website was last updated on September 3<sup>rd</sup>, 2024.
 
 This is **the official website on ICA EGAD Records in Contexts-Ontology (ICA RiC-O)**. It is an HTML version of the documentation that was prepared about the ontology and whose Markdown sources are in the [GitHub repository](https://github.com/ICA-EGAD/RiC-O). It also provides useful links to the other contents of this repository.
 
-The **latest public release of RiC-O, RiC-O 1.0.1, is dated May 13, 2024**. You can find it in the GitHub repository, in the [ontology/current-version](https://github.com/ICA-EGAD/RiC-O/tree/master/ontology/current-version) subfolder.
+The **latest public release of RiC-O, RiC-O 1.0.2, is dated September 2, 2024**. You can find it in the GitHub repository, in the [ontology/current-version](https://github.com/ICA-EGAD/RiC-O/tree/master/ontology/current-version) subfolder.
 
 It is also **available to machines and human readers through its IRI ([https://www.ica.org/standards/RiC/ontology](https://www.ica.org/standards/RiC/ontology))**.
 
-RiC-O 1.0.1 is **based on the latest version of Records in Contexts-Conceptual Model (RiC-CM), RiC-CM 1.0, which was released on November 30, 2023**, and which is available for download [here](https://github.com/ICA-EGAD/RiC-CM/releases/tag/v1.0.1), or [from the ICA website](https://www.ica.org/app/uploads/2023/12/RiC-CM-1.0.pdf).
+RiC-O 1.0.2 is **based on the latest version of Records in Contexts-Conceptual Model (RiC-CM), RiC-CM 1.0, which was released on November 30, 2023**, and which is available for download [here](https://github.com/ICA-EGAD/RiC-CM/releases/tag/v1.0.1), or [from the ICA website](https://www.ica.org/app/uploads/2023/12/RiC-CM-1.0.pdf).
 
 
 **If you want to contact us, or send comments and questions, you can use the new [Records in Contexts users Google group](https://groups.google.com/g/Records_in_Contexts_users)**.

docs/about.md

@@ -14,14 +14,20 @@
 
 
 
-Last updated on May 13<sup>th</sup>, 2024
+Last updated on September 3<sup>rd</sup>, 2024
 
 
 RiC-O (Records in Contexts-Ontology) is **an OWL 2 ontology for describing archival record resources**, whose IRI is [https://www.ica.org/standards/RiC/ontology](https://www.ica.org/standards/RiC/ontology). As **the third part of Records in Contexts (RiC) standard**, it is a formal representation of Records in Contexts Conceptual Model (RiC-CM).
 
-The **latest public release of RiC-O, RiC-O 1.0.1, was published in May 2024**. It was released a few weeks after the first stable and complete version of this ontology, thus a major milestone, **RiC-O 1.0**, replacing RiC-O 0.2, which was released in February 2021. Apart from slightly modifying or updating a few details in the introduction and fixing a few typos in the documentation of RiC-O 1.0, version 1.0.1 only brings one change: it fixes the IRI of 'hasOrHadSomeMemberswithDocumentaryFormType' object property (changed to 'rico:hasOrHadSomeMembersWithDocumentaryFormType'). It is fully documented in English and available in the RiC-O GitHub repository, in the [current-version](https://github.com/ICA-EGAD/RiC-O/tree/master/ontology/current-version) folder. It comes with some [examples](examples.html) and [diagrams](diagrams.html). 
+The **latest public release of RiC-O, RiC-O 1.0.2, was published in September 2024**. **Version 1.0.2 follows the release of RiC-O 1.0.1, dated May 2024, and the release of the first stable and complete version of this ontology, thus a major milestone, RiC-O 1.0**. 
 
-**RiC-O 1.0.1 is compliant with the latest version of Records in Contexts-Conceptual Model (RiC-CM), RiC-CM 1.0, which was released in November 2023** and is available for download is available for download  [here](https://github.com/ICA-EGAD/RiC-CM/releases/tag/v1.0.1), or [from the ICA website](https://www.ica.org/app/uploads/2023/12/RiC-CM-1.0.pdf).
+Version 1.0.1 modified a few details in the introduction, fixed a few typos in the documentation of RiC-O 1.0, and brought one change only, fixing the IRI of 'hasOrHadSomeMemberswithDocumentaryFormType' object property (changed to [rico:hasOrHadSomeMembersWithDocumentaryFormType](https://www.ica.org/standards/RiC/ontology#hasOrHadSomeMembersWithDocumentaryFormType)). 
+
+Version 1.0.2 fixes an inconsistency bug in RiC-O 1.0, removing global reflexivity from the 48 rolification object properties. It also fixes the French labels of six object properties. Finally, a version IRI (owl:versionIRI) has been added to this 1.0.2 version, in order to make RiC-O fully compliant with the OWL 2 specification as concerns ontology documents.
+
+Version 1.0.2 is fully documented in English and available in the RiC-O GitHub repository, in the [current-version](https://github.com/ICA-EGAD/RiC-O/tree/master/ontology/current-version) folder. It comes with some [examples](examples.html) and [diagrams](diagrams.html). 
+
+**RiC-O 1.0.2 is compliant with the latest version of Records in Contexts-Conceptual Model (RiC-CM), RiC-CM 1.0, which was released in November 2023** and is available for download is available for download  [here](https://github.com/ICA-EGAD/RiC-CM/releases/tag/v1.0.1), or [from the ICA website](https://www.ica.org/app/uploads/2023/12/RiC-CM-1.0.pdf).
 
 The version 1.0 of RiC-FAD, RiC-CM, and RiC-O marks **the first stable and complete version of the first three parts of RiC, and thus a major milestone in the development of the standard**. 
 

docs/migrating-data-from-RIC-O-v0.2-to-v1.0.md

@@ -1,4 +1,4 @@
-# Migrating data from RiC-O 0.2 to RiC-O 1.0
+# Migrating data from RiC-O 0.2 to RiC-O 1.0.2
 
 
 
@@ -14,19 +14,19 @@
 
 
 
-Last updated on May 13<sup>th</sup>, 2024
+Last updated on September 3<sup>rd</sup>, 2024
 
-Though the following information and recommendations do not for now pretend to be exhaustive, we hope that they can help the teams which have already produced datasets conforming to RiC-O (thus to RiC-0 0.2) to make them compliant with RiC-O 1.0.1.
+Though the following information and recommendations do not for now pretend to be exhaustive, we hope that they can help the teams which have already produced datasets conforming to RiC-O (thus to RiC-0 0.2) to make them compliant with RiC-O 1.0.2.
 
-**RiC-O 1.0**, which is the first stable and complete version of RiC ontology, and thus a major milestone in the development of the standard, **introduced some new components; it also brought some changes on the specifications of the v0.2 components**: the qualified names, definitions, domains or ranges of some have changed. Besides, some components have been removed. In other words, RiC-O 1.0 and therefore RiC-O 1.0.1, are not, as a whole, compatible with RiC-O 0.2. This is why, **if you have been using RiC-O 0.2 and want to move to RiC-O 1.0.1 (which we would recommend), you may need to modify your data**.
+**RiC-O 1.0**, which is the first stable and complete version of RiC ontology, and thus a major milestone in the development of the standard, **introduced some new components; it also brought some changes on the specifications of the v0.2 components**: the qualified names, definitions, domains or ranges of some have changed. Besides, some components have been removed. In other words, RiC-O 1.0 and therefore RiC-O 1.0.2, are not, as a whole, compatible with RiC-O 0.2. This is why, **if you have been using RiC-O 0.2 and want to move to RiC-O 1.0.2 (which we would recommend), you may need to modify your data**.
 
 We will mainly **focus on the most significant changes made to RiC-O 0.2 components**, starting with the ones that concern the core of RiC-O (i.e. everything but the Relation classes and their properties). We will also emphasize some additions that may be very useful in some projects.
 
 **Before modifying your data**, in order to get a more precise understanding of what has to be done in your dataset, **you should, in addition to reading this text**:
 - **open the ontology file in an OWL ontology editor, browse it or directly search the component you have in mind**; any change made to an existing component has been documented precisely;
 - **have a look at the [three CSV files provided](https://github.com/ICA-EGAD/RiC-O/tree/master/ontology/current-version/CSV_lists_of_components)**, whose last column lists the changes made from RiC-O 0.2 for each component.
 
-In the following lines, we use the `rico` prefix only for RiC-O 1.0.1 components.
+In the following lines, we use the `rico` prefix only for RiC-O 1.0.2 components.
 
 
 ## Changes affecting the core of RiC-O
@@ -52,7 +52,7 @@ A `rico:MandateType` class was created, as a subclass of `rico:RuleType`, along
 
 In addition to the datatype properties whose domain is `rico:Date` and which are quoted above, **you should pay attention to the following changes**:
 - ***descriptiveNote***, which had domain `rico:Thing` and is therefore most probably being very widely used, **was replaced with `rico:generalDescription`**, with a slightly different textual definition; `rico:scopeAndContent` was made a subproperty of `rico:generalDescription`. 
-- ***accrual* was replaced with `rico:accruals`**, and *accrualStatus* with rico:accrualsStatus`.
+- ***accrual* was replaced with `rico:accruals`**, and *accrualStatus* with `rico:accrualsStatus`.
 - *integrity* was replaced with `rico:integrityNote` (with domain `rico:RecordResource` only) and *physicalCharacteristics* with `rico:physicalCharacteristicsNote`; *qualityOfRepresentation* was replaced with `rico:qualityOfRepresentationNote` and made a subproperty of `rico:physicalCharacteristicsNote`.
 
 A new `rico:length` property was created, subproperty of `rico:measure`, with domain `rico:Thing`.
@@ -64,7 +64,7 @@ A new `rico:destructionDate` property was created, subproperty of `rico:endDate`
 
 The following changes have been made:
 - ***hasInstantiation*  was replaced with `rico:hasOrHadInstantiation`** (same for the inverse object property, which is now `rico:isOrWasInstantiationOf`)
-- ***hasDerivedInstantiation* was replaced with `rico:hasOrHadDerivedInstantiation`** (same for the inverse property, which is now `rico:isOrWasDerivedFromInstantiatio`n)
+- ***hasDerivedInstantiation* was replaced with `rico:hasOrHadDerivedInstantiation`** (same for the inverse property, which is now `rico:isOrWasDerivedFromInstantiation`)
 - ***hasProvenance* was replaced with `rico:hasOrganicProvenance`**, subproperty of the new `rico:hasOrganicOrFunctionalProvenance`; `rico:documents` was also made a subproperty of this new property; same for the inverse properties
 - ***hasSource* (whose domain was the union of RecordResource and Relation) was removed**; a new `rico:isEvidencedBy` property has been created, with domain `rico:Relation` only; same for the inverse property, *isSourceOf*
 - **`rico:precedesInTime` and `rico:followsInTime` were made transitive**.
@@ -109,7 +109,7 @@ As already said above, the *hasSource* object property, whose domain included `r
 
 As a consequence:
 - **166 specific object properties, defined in RiC-O to connect entities to these relations, were removed**. If you have instantiated Relation classes in your RiC-O 0.2 dataset, you should replace these object properties with the following properties, which existed already: either `rico:relationConnects` (if the Relation class used is not oriented, e.g. for `rico:AgentToAgentRelation`) or `rico:relationHasSource` and `rico:relationHasTarget` (if the Relation class used is oriented, e.g. for `rico:LeadershipRelation`);
-- a new reflexive object property, whose name ends with a `_role` suffix, was defined for each of the 48 Relation classes, with domain and range the concerned class;
+- a new object property, whose name ends with a `_role` suffix, was defined for each of the 48 Relation classes, with domain and range the concerned class;
 - the property chain axioms that had been defined for the binary shortcuts corresponding to the classes, were modified.
 
 Again, you can read much more details about this on the page related to [issue 67](https://github.com/ICA-EGAD/RiC-O/issues/67).
@@ -120,18 +120,17 @@ Figure 1 shows how this relation is expressed using RiC-O 0.2.
 
 ![images/a-complex-relation-and-its-shortcut_inRiC-O_0.2.png](images/a-n-ary-relation-and-its-shortcut_inRiC-O_0.2.png)
 
-Figure 2 shows how the same relation is now expressed using RiC-O 1.0.
-
-![images/a-complex-relation-and-its-shortcut_inRiC-O_1.0.png](images/a-n-ary-relation-and-its-shortcut_inRiC-O_1.0.png)
+Figure 2 shows how the same relation is now expressed using RiC-O 1.0.2.
 
+![images/a-complex-relation-and-its-shortcut_inRiC-O_1.0.2.png](images/a-complex-relation-and-its-shortcut_inRiC-O_1.0.2.png)
 
 
 The image below shows the RDF/XML data that corresponds to Figure 2.
 
 ![images/rico_LeadershipRelation.png](images/leadershipRelation_in_RDF.png)
 
 
-The `rico:LeadershipRelation` itself is now defined as follows in RiC-O 1.0 (see the ontology file or HTML page to get the full specification):
+The `rico:LeadershipRelation` itself is now defined as follows in RiC-O 1.0.2 (see the ontology file or HTML page to get the full specification):
 
 ![images/rico_LeadershipRelation.png](images/rico_LeadershipRelation.png)
 

examples/examples_v1-0/NationalArchivesOfFrance/readme.md

@@ -27,7 +27,7 @@ https://www.siv.archives-nationales.culture.gouv.fr/siv/NP/{AR_Id}, where '{AR_i
 
 **These source files are provided as example files but do not represent the variety of the 32000 finding aids and 16000 authority records that the ANF hold**. They have been chosen because they are linked to each other, and because an earlier version of them was used for the French RDF/RiC proof of concept released in February 2018 ([https://piaaf.demo.logilab.fr](https://piaaf.demo.logilab.fr)). **They do not either always conform to the local best practice as recommended in the application guidelines used in the ANF**.
 
-**The 'rdf-xml' folder contains the RDF files generated from the  'examples_v1-0/NationalArchivesOfFrance/rdf-xml' folder, and conforming to RiC-O v1.0.1**. Each EAC-CPF or EAD file corresponds to one RDF/RiC-O source file. 
+**The 'rdf-xml' folder contains the RDF files generated from the  'examples_v1-0/NationalArchivesOfFrance/rdf-xml' folder, and conforming to RiC-O v1.0.2**. Each EAC-CPF or EAD file corresponds to one RDF/RiC-O source file. 
 The 'vocabularies' subfolder contains a first, most often quite poor and not complete, RDF/RiC-O version of some of the controlled vocabularies used in the ANF, for indexing the EAD and EAC-CPF files. Though the RDF files refer to some instances of RiC-O Place, the ANF authority records on places are not provided in this folder. The files provided here are part of the files published in another public GitHub repository ([https://github.com/ArchivesNationalesFR/Referentiels](https://github.com/ArchivesNationalesFR/Referentiels)).
 
 **The base URI defined for these RDF resources is: http://data.archives-nationales.culture.gouv.fr/. It is fictitious**: the URIs are not yet dereferencable. The RDF dataset is provided only as an example RiC-O archival dataset.

examples/examples_v1-0/Readme.md

@@ -1,6 +1,6 @@
 # Examples for RiC-O Version 1.0
 
-This is where you will find examples of RDF files conforming to RiC-O 1.0.1, and of the source files used for creating the RDF datasets.
+This is where you will find examples of RDF files conforming to RiC-O 1.0.2, and of the source files used for creating the RDF datasets.
 
 If you would like to provide other examples or references to other examples, do not hesitate to contact EGAD ! You can either create an issue on this repository, or use the [Records in Contexts users Google group](https://groups.google.com/g/Records_in_Contexts_users).