From ae543178f6c78f04f36b028c447220b496deb04f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Maxime=20Lefran=C3=A7ois?= Date: Fri, 1 Dec 2023 14:54:25 +0100 Subject: [PATCH 1/3] Update README.md --- README.md | 113 +++++++++++++++--------------------------------------- 1 file changed, 31 insertions(+), 82 deletions(-) diff --git a/README.md b/README.md index 8e8e21aa..65e8a9f2 100644 --- a/README.md +++ b/README.md @@ -1,117 +1,66 @@ -# Hyperagent ontology git space +# The Hypermedia Multi-Agent Systems (hMAS) Ontology -[HyperAgents](https://www.hyperagents.org/) is an ANR/SNF project working towards the deployment of world-wide hybrid communities of people and artificial agents on the Web. For this purpose, we are defining a new class of multi-agent systems (MAS) that are: +<< Motivation: overview of the Hypermedia MAS >> -1) aligned with the Web architecture to inherit the properties of the Web as a world-wide, open, and long-lived system ; +Our vision is ... the deployment of world-wide hybrid communities of people and artificial agents on the Web. For this purpose, we are defining a new class of multi-agent systems (MAS) that are: +1) aligned with the Web architecture to inherit the properties of the Web as a world-wide, open, and long-lived system ; 2) transparent and accountable to support acceptance by people. -Our systems use semantic hypermedia to enable uniform interaction among heterogeneous entities in MAS: people, artificial agents, devices, digital serivces, knowledge repositories, etc. We refer to this new class of Web-based MAS as Hypermedia MAS. +Our systems use semantic hypermedia to enable uniform interaction among heterogeneous entities in MAS: people, artificial agents, devices, digital services, knowledge repositories, etc. We refer to this new class of Web-based MAS as Hypermedia MAS. To undertake this investigation, HyperAgents brings together internationally recognized researchers actively contributing to research on autonomous agents and MAS, the Web architecture and the Web of Things, Semantic Web and Linked Data, and to the standardization of the Web. +## Overview +<< overview of the ontology and definitions of the most stable important terms ? + todo: update the figure >> ![view of the ontology](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/resources/hmas-webvowl-v2.jpg) +<> +Main modules: +- [core](): +- [interaction](): +- [regulation](): -## I - General information - -This git repository contains the methodology and results of the ontology modelling activity of the [HyperAgent project](https://www.hyperagents.org/). -The root of the repository contains three introductory files respectively describing the code of conduct, the process for contributing and the method followed for designing this ontology. - -## II - Guide and standardistaiion -### 1) How to use the ontology +## How to use +<< check the content of the linked file ! >> The file [current ontology](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/MODELING-ONTOLOGIES.md) describes : * the different features of the project * how to use in practice the ontology +### How to get involved -### 2) How to contribute to HyperAgent - -If you want to contribute, please follow the [contributing file](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/CONTRIBUTING.md). - - -## III - Versions - - - -List of the latest versions : -* V1 - (15/04/22) - [Core ontology](https://github.com/HyperAgents/ns.hyperagents.org/milestone/1?closed=1) - - -## IV - Authors - - -* [Fabien Gandon](http://fabien.info/) - - email : fabien.gandon@inria.fr - - affiliation : [INRIA](https://inria.fr/) - +### Contribute to the ontology +issues, etc. -* [Chistopher Leturc](https://emse.fr/~leturc/) - - email : christopher.leturc@inria.fr - - affiliation : [INRIA](https://inria.fr/) - - -* [Maxime LefranΓ§ois](http://maxime-lefrancois.info/me#) - - email : maxime.lefrancois@emse.fr - - affiliation : [EMSE](https://www.mines-stetienne.fr/) - - -* [Andrei Ciortea](http://iri.for/andrei) - - email : andrei.ciortea@unisg.ch - - affiliation : [UNISG](https://www.unisg.ch/en) +If you want to contribute, please follow the [contributing file](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/CONTRIBUTING.md). -* [Olivier Boissier](https://www.emse.fr/~boissier/) +This git repository contains the methodology and results of the ontology modelling activity of the [HyperAgent project](https://www.hyperagents.org/). +The root of the repository contains three introductory files respectively describing the code of conduct, the process for contributing and the method followed for designing this ontology. - email : "olivier.boissier@emse.fr" - - affiliation : [EMSE](https://mines-stetienne.fr) - -* [Danai Vachtsevanou](https://danaivach.inrupt.net/profile/card#me) +### Participate to the community group - email : danai.vachtsevanou@unisg.ch - - affiliation : [UNISG](https://www.unisg.ch/en) +blabla -* [Luis Gustavo Nardin](https://www.emse.fr/~gardin/) +## Licence - email : "gnardin@emse.fr" - - affiliation : [EMSE](https://mines-stetienne.fr) +This ontology is licensed under the [CC BY 4.0 DEED license](LICENSE.md) +<< check the license metadata in the ontology corresponds to the LICENSE.md file >> -## V - Licence +## How to Cite +Zenodo ? DOI ? github file for canonical citation CITATION.cff ## Acknowledgments -We thank INRIA/UNISG/EMSE for supporting and hosting this project. +This project was initially funded by the [HyperAgents](https://www.hyperagents.org/) project, an ANR/SNF project +<< mention Community Group ? >> -## Ideas for the README - -Section : Getting started ? - -Subsection: Prerequisites ? - -Subsection : Installing the project and dependencies ? - -Subsection : Running the project ? - - - -## References - +We thank INRIA/UNISG/EMSE for supporting and hosting this project. -* https://2associes.com/readme-sa-structure-et-son-contenu/ +funding agencies From 51c804efbf56522b09680e02c5f1b60f4f7636cc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Maxime=20Lefran=C3=A7ois?= Date: Fri, 1 Dec 2023 15:04:09 +0100 Subject: [PATCH 2/3] proposed update for README.md --- README.md | 82 +++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 73 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 65e8a9f2..d653b292 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +<< badges ! @nico >> + # The Hypermedia Multi-Agent Systems (hMAS) Ontology << Motivation: overview of the Hypermedia MAS >> @@ -10,9 +12,14 @@ Our vision is ... the deployment of world-wide hybrid communities of people and Our systems use semantic hypermedia to enable uniform interaction among heterogeneous entities in MAS: people, artificial agents, devices, digital services, knowledge repositories, etc. We refer to this new class of Web-based MAS as Hypermedia MAS. To undertake this investigation, HyperAgents brings together internationally recognized researchers actively contributing to research on autonomous agents and MAS, the Web architecture and the Web of Things, Semantic Web and Linked Data, and to the standardization of the Web. -## Overview + +## Getting started << overview of the ontology and definitions of the most stable important terms ? + todo: update the figure >> + +* link to the documentation online https://purl.org/hmas/ +* link to the primer + ![view of the ontology](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/resources/hmas-webvowl-v2.jpg) <> @@ -21,26 +28,83 @@ Main modules: - [interaction](): - [regulation](): +for bugs and feature requests, please [raise an issue](issues/new) and follow the templates there -## How to use - -<< check the content of the linked file ! >> -The file [current ontology](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/MODELING-ONTOLOGIES.md) describes : -* the different features of the project -* how to use in practice the ontology -### How to get involved +### Contributing ### Contribute to the ontology -issues, etc. + +<< check the content of the linked file ! >> +The file [current ontology](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/MODELING-ONTOLOGIES.md) describes : +* the different features of the project If you want to contribute, please follow the [contributing file](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/CONTRIBUTING.md). +## About this repository This git repository contains the methodology and results of the ontology modelling activity of the [HyperAgent project](https://www.hyperagents.org/). The root of the repository contains three introductory files respectively describing the code of conduct, the process for contributing and the method followed for designing this ontology. +<> +Main modules: +- [core](): +- [interaction](): +- [regulation](): + + +### Top-level directory +The repository folders both core ontology and domain-specific ontologies (blabla and blabla). Each ontology is defined in modular fashion. The overall structure is as follows. + +``` +πŸ“‚ hmas +β”‚ +β”œβ”€ πŸ“ core +β”‚ β”œβ”€β”€ πŸ“ blabla +β”‚ β”œβ”€β”€ πŸ“ ........ +β”‚ β”œβ”€β”€ πŸ“ blabla +β”‚ β”œβ”€β”€ πŸ“ blabla +β”‚ └── πŸ“„ README.md +β”‚ +β”œβ”€ πŸ“ domains +β”‚ β”œβ”€β”€ πŸ“ blabla +β”‚ β”œβ”€β”€ πŸ“ blabla +β”‚ └── πŸ“„ README.md +β”‚ +β”œβ”€ πŸ“ .acimov ---> ideally, this folder should be deleted +β”‚ β”œβ”€β”€ πŸ“ DOGenerator +β”‚ β”œβ”€β”€ πŸ“ KGGenerator +β”‚ β”œβ”€β”€ πŸ“ docs +β”‚ β”œβ”€β”€ πŸ“ tests +β”‚ └── πŸ“„ README.md +β”‚ +β”œβ”€ πŸ“ src +β”‚ +β”œβ”€ πŸ“„ README.md +β”‚ +β””β”€β”€πŸ”‘ LICENSE +``` +### πŸ“ Core directory + +The core directory contains the core ontology definition organized in modules. Each module folder contains: +``` + . + β”œβ”€β”€ πŸ“„ onto.ttl /* T-box + β”œβ”€β”€ πŸ“„ dataset.ttl /* A-box + β”œβ”€β”€ πŸ–ΌοΈ diagram. /* eg. CHOWLK diagram + β”œβ”€β”€ ❓ cq-Q.rq /* A set of Competency questions translated as Sparql query. + └── πŸ“„ readme.md +``` + +### πŸ“ Domain directory + +For each application domain (bklabla/blabla), the domain folder contains the motivating scenarios (modules) illustrating the ontology use. Module folders are organized as for core ontology folder modules, with additional domain-specific definitions. + +### πŸ“ ACIMOV scripts directory + +The `.acimov` folder contains necessary [**scripts**](./.acimov/README.md) for automating ontology building: automatic integration, testing, documentation publishing,.... + ### Participate to the community group From cb1571b55b161aefc27c4508d493f7b3b641c39a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Maxime=20Lefran=C3=A7ois?= Date: Fri, 1 Dec 2023 15:06:10 +0100 Subject: [PATCH 3/3] CG wrong section --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index d653b292..7ec19024 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,10 @@ The file [current ontology](https://github.com/HyperAgents/ns.hyperagents.org/bl If you want to contribute, please follow the [contributing file](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/CONTRIBUTING.md). +### Participate to the community group + +blabla + ## About this repository This git repository contains the methodology and results of the ontology modelling activity of the [HyperAgent project](https://www.hyperagents.org/). @@ -106,10 +110,6 @@ For each application domain (bklabla/blabla), the domain folder contains the mot The `.acimov` folder contains necessary [**scripts**](./.acimov/README.md) for automating ontology building: automatic integration, testing, documentation publishing,.... -### Participate to the community group - -blabla - ## Licence This ontology is licensed under the [CC BY 4.0 DEED license](LICENSE.md)