From 3f741e451111b41e9f16b23540602e2c6e898d9e Mon Sep 17 00:00:00 2001 From: danaivach Date: Wed, 14 Jun 2023 16:02:22 +0200 Subject: [PATCH 01/12] create domain description --- domains/tackling-online-disinformation/README.md | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 domains/tackling-online-disinformation/README.md diff --git a/domains/tackling-online-disinformation/README.md b/domains/tackling-online-disinformation/README.md new file mode 100644 index 00000000..ce506411 --- /dev/null +++ b/domains/tackling-online-disinformation/README.md @@ -0,0 +1,4 @@ +# Tackling Online Disinformation Domain + +## Overview +The Tackling Online Disinformation domain is illustrated using the example of a multi-agent systems where autonomous agents collaborate with each other to curate and label information on the Web towards tackling online disinformation. From 25b7ad021e201ae91bd4b8fa7dd2445f4ae4d4e8 Mon Sep 17 00:00:00 2001 From: danaivach Date: Wed, 14 Jun 2023 16:02:44 +0200 Subject: [PATCH 02/12] Fix typo --- domains/tackling-online-disinformation/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/domains/tackling-online-disinformation/README.md b/domains/tackling-online-disinformation/README.md index ce506411..71d5443d 100644 --- a/domains/tackling-online-disinformation/README.md +++ b/domains/tackling-online-disinformation/README.md @@ -1,4 +1,4 @@ # Tackling Online Disinformation Domain ## Overview -The Tackling Online Disinformation domain is illustrated using the example of a multi-agent systems where autonomous agents collaborate with each other to curate and label information on the Web towards tackling online disinformation. +The Tackling Online Disinformation domain is illustrated using the example of a multi-agent system where autonomous agents collaborate with each other to curate and label information on the Web towards tackling online disinformation. From e33f62179bc6ee22237cf11b838ffc5dcb02e51b Mon Sep 17 00:00:00 2001 From: danaivach Date: Thu, 15 Jun 2023 20:01:30 +0200 Subject: [PATCH 03/12] feat(join-organization) add dataset --- .../join-organization/dataset.ttl | 420 ++++++++++++++++++ 1 file changed, 420 insertions(+) create mode 100644 domains/tackling-online-disinformation/join-organization/dataset.ttl diff --git a/domains/tackling-online-disinformation/join-organization/dataset.ttl b/domains/tackling-online-disinformation/join-organization/dataset.ttl new file mode 100644 index 00000000..6443dc31 --- /dev/null +++ b/domains/tackling-online-disinformation/join-organization/dataset.ttl @@ -0,0 +1,420 @@ +@prefix ex: . +@prefix hmas: . +@prefix rdfs: . +@prefix sh: . +@prefix prov: . +@prefix hctl: . +@prefix htv: . +@prefix rdf: . +@prefix xs: . + +################################################################# +# Core Ontology +################################################################# + +## Workspace +ex:NewsNetworkWS a hmas:Workspace ; + hmas:contains ex:John, ex:Alice, ex:Bob, ex:Carol, ex:David, ex:Elton, ex:Walter, ex:AnnotatingService, ex:OrganizationBoard. + +## Agents +ex:John a hmas:Agent ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMemberOf ex:TOD_Network . +ex:Alice a hmas:Agent ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMemberOf ex:TOD_Network . +ex:Bob a hmas:Agent ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMemberOf ex:TOD_Network . +ex:Carol a hmas:Agent ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMemberOf ex:TOD_Network . +ex:David a hmas:Agent ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMemberOf ex:TOD_Network . +ex:Elton a hmas:Agent ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMemberOf ex:TOD_Network . +ex:Walter a hmas:Agent ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMemberOf ex:TOD_Network . + +## Artifacts +ex:AnnotatingService a hmas:Artifact ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMaterialOf ex:TOD_Network . +ex:OrganizationBoard a hmas:Artifact ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMaterialOf ex:TOD_Network ; + hmas:hasProfile ex:OrganizationBoardProfile. + +################################################################# +# Regulation Ontology +################################################################# + +# SPECIFICATION + +## NOTE: Regulation entities' specification can be represented +## using implicit or explicit Target Class SHACL. Here we +## decided to use implicit Target Class SHACL because we +## do not expect any extensions for this scenario and we +## wanted to avoid extra labels. + +## Organization Specification +ex:NewsNetwork a sh:NodeShape ; + rdfs:subClassOf hmas:Organization ; + sh:property [ + sh:path hmas:hasOrganizationalValue ; + sh:qualifiedValueShape [ sh:class ex:Accountability ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:hasOrganizationalValue ; + sh:qualifiedValueShape [ sh:class ex:Transparency ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:ActiveUser ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:Journalist ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:GeneralEvaluator ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:GeneralInvestigator ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:ImageInvestigator ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:Admin ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:Aggregator ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:providesRole ; + sh:qualifiedValueShape [ sh:class ex:Control ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesMission ; + sh:qualifiedValueShape [ sh:class ex:ContentEvaluationMission ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesMission ; + sh:qualifiedValueShape [ sh:class ex:ArticleCredibilityMission ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesMission ; + sh:qualifiedValueShape [ sh:class ex:ImageProvenanceMission ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesMission ; + sh:qualifiedValueShape [ sh:class ex:SystemFunctionalityMission ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesMission ; + sh:qualifiedValueShape [ sh:class ex:ControlMission ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesFacility ; + sh:qualifiedValueShape [ sh:class ex:NewsNetworkAnnotatingService ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesFacility ; + sh:qualifiedValueShape [ sh:class ex:NewsNetworkOrganizationBoard ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:proposesFacility ; + sh:qualifiedValueShape [ sh:class ex:NewsNetworkGroupBoard ] ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] . + +## Organizational Values +ex:Accountability a sh:NodeShape ; + rdfs:subClassOf hmas:OrganizationalValue ; + rdfs:comment "Accompany information evaluations with details about who contributed to the tackling disinformation process, e.g. which agents evaluated the information."@en ; + rdfs:label "accountability"@en, "responsabilité"@fr . + +ex:Transparency a sh:NodeShape ; + rdfs:subClassOf hmas:OrganizationalValue ; + rdfs:comment "Accompany information evaluations with details about how one contributed to the tackling disinformation process, e.g. what external services were used to evaluate the information."@en ; + rdfs:label "transparency"@en, "transparence"@fr . + +## Roles +ex:ActiveUser a sh:NodeShape ; + rdfs:subClassOf hmas:Role . +ex:Journalist a sh:NodeShape ; + rdfs:subClassOf hmas:ActiveUser . +ex:GeneralEvaluator a sh:NodeShape ; + rdfs:subClassOf hmas:Journalist . +ex:GeneralInvestigator a sh:NodeShape ; + rdfs:subClassOf hmas:Journalist . +ex:ImageInvestigator a sh:NodeShape ; + rdfs:subClassOf hmas:Journalist . +ex:Admin a sh:NodeShape ; + rdfs:subClassOf hmas:Role . +ex:Agreegator a sh:NodeShape ; + rdfs:subClassOf hmas:Admin . +ex:Control a sh:NodeShape ; + rdfs:subClassOf hmas:Role . + +## Missions +ex:ContentEvaluationMission a sh:NodeShape ; + rdfs:subClassOf hmas:Mission . +ex:ArticleCredibilityMission a sh:NodeShape ; + rdfs:subClassOf hmas:Mission . +ex:ImageProvenanceMission a sh:NodeShape ; + rdfs:subClassOf hmas:Mission . +ex:SystemFunctionalityMission a sh:NodeShape ; + rdfs:subClassOf hmas:Mission . +ex:ControlMission a sh:NodeShape ; + rdfs:subClassOf hmas:Mission . + +## Facilities +ex:NewsNetworkAnnotatingService a sh:NodeShape ; + rdfs:subClassOf hmas:Facility . +ex:NewsNetworkOrganizationBoard a sh:NodeShape ; + rdfs:subClassOf hmas:Facility . +ex:NewsNetworkGroupBoard a sh:NodeShape ; + rdfs:subClassOf hmas:Facility . + +## Group +ex:OnlineDisinformationTacklingTeam a sh:NodeShape ; + rdfs:subClassOf hmas:Group . + +## Membership +ex:OnlineDisinformationTacklingMembership a sh:NodeShape ; + rdfs:subClassOf hmas:Membership ; + sh:property [ + sh:path hmas:isMembershipOf ; + sh:qualifiedValueShape [ sh:class hmas:Agent ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipFor ; + sh:qualifiedValueShape [ sh:class hmas:Role ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipIn ; + sh:qualifiedValueShape [ sh:class ex:OnlineDisinformationTacklingTeam ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] . + +# INSTANTIATION + +## Organizational Values +ex:TOD_Accountability a ex:Accountability . +ex:TOD_Transparency a ex:Transparency . + +# Groups +## Groups +ex:TOD_OnlineDisinformationTacklingTeam a ex:OnlineDisinformationTacklingTeam ; + hmas:structures ex:TOD_Network . + +## Roles +ex:TOD_ActiveUser a ex:ActiveUser . +ex:TOD_Journalist a ex:Journalist . +ex:TOD_GeneralEvaluator a ex:GeneralEvaluator . +ex:TOD_GeneralInvestigator a ex:GeneralInvestigator . +ex:TOD_ImageInvestigator a ex:ImageInvestigator . +ex:TOD_Admin a ex:Admin . +ex:TOD_Aggregator a ex:Aggregator . +ex:TOD_Control a ex:Control . + +## Missions +ex:TOD_ContentEvaluationMission a ex:ContentEvaluationMission . +ex:TOD_ArticleCredibilityMission a ex:ArticleCredibilityMission . +ex:TOD_ImageProvenanceMission a ex:ImageProvenanceMission . +ex:TOD_SystemFunctionalityMission a ex:SystemFunctionalityMission . +ex:TOD_ControlMission a ex:ControlMission . + +## Facility +ex:TOD_NewsNetworkAnnotatingService a ex:NewsNetworkAnnotatingService. +ex:TOD_NewsNetworkOrganizationBoard a ex:NewsNetworkOrganizationBoard. +ex:TOD_Network hmas:proposesFacility ex:TOD_NewsNetworkGroupBoard. + + +## Organizations +ex:TOD_NetworkProfile a hmas:ResourceProfile; + hmas:isProfileOf ex:TOD_Network. + +ex:TOD_Network a ex:NewsNetwork ; + hmas:hasProfile ex:TOD_NetworkProfile ; + hmas:hasOrganizationalValue ex:TOD_Accountability, ex:TOD_Transparency ; + hmas:providesRole ex:TOD_ActiveUser, ex:TOD_Journalist, ex:TOD_GeneralEvaluator, ex:TOD_GeneralInvestigator, ex:TOD_ImageInvestigator, ex:TOD_Admin, ex:TOD_Aggregator, ex:TOD_Contol; + hmas:proposesMission ex:TOD_ContentEvaluationMission, ex:TOD_ArticleCredibilityMission, ex:TOD_ImageProvenanceMission, ex:TOD_SystemFunctionalityMission, ex:TOD_ControlMission ; + hmas:proposesFacility ex:TOD_NewsNetworkAnnotatingService, ex:TOD_NewsNetworkOrganizationBoard . + +################################################################# +# Interaction Ontology +################################################################# + +## Organization board profile +ex:OrganizationBoardProfile a hmas:ResourceProfile; + hmas:isProfileOf ex:OrganizationBoard; + hmas:exposesSignifier ex:EnterOrganizationSignifier, ex:CreateGroupSignifier. + +## Signifiers +ex:EnterSignifier a hmas:Signifier; + hmas:signifies ex:EnterOrganization. +ex:CreateGroupSignifier a hmas:Signifier; + hmas:signifies ex:CreateGroup. + +## Action Execution Specifications +ex:EnterOrganization a sh:NodeShape ; + rdfs:subClassOf hmas:ActionExecution ; + sh:property [ + sh:path prov:used ; + sh:hasValue ex:HTTPForm1 ; + ] ; + sh:property [ + sh:path hmas:hasInput; + sh:qualifiedValueShape ex:Credentials ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] . + +ex:CreateGroup a sh:NodeShape ; + rdfs:subClassOf hmas:ActionExecution ; + sh:property [ + sh:path prov:used ; + sh:hasValue ex:HTTPForm2 ; + ] ; + sh:property [ + sh:path hmas:hasInput; + sh:qualifiedValueShape ex:Credentials ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] . + +## Forms +ex:HTTPForm1 a hctl:Form ; + hctl:target ; + hctl:forContentType "application/json" ; + htv:methodName "POST". + +ex:HTTPForm2 a hctl:Form ; + hctl:target ; + hctl:forContentType "application/json" ; + htv:methodName "POST". + +## Input Specifications +ex:Credentials a sh:NodeShape ; + rdfs:subClassOf hmas:Input ; + sh:property [ + sh:path [ sh:inversePath rdf:type ] ; + sh:minCount 1 ; + sh:maxCount 1 ; + ] ; + sh:property [ + sh:path ex:hasHypothesisAPIKey ; + sh:qualifiedValueShape xs:string ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] . + +ex:GroupInput a sh:NodeShape ; + rdfs:subClassOf hmas:Input ; + sh:property [ + sh:path [ sh:inversePath rdf:type ] ; + sh:minCount 1 ; + sh:maxCount 1 ; + ] ; + sh:property [ + sh:path ex:hasGroupClass ; + sh:qualifiedValueShape hmas:Group ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] . + +## GROUP BOARD INITIALIZATION +ex:NewsNetworkWS hmas:contains ex:GroupBoard. + +ex:GroupBoard a hmas:Artifact ; + hmas:isContainedIn ex:NewsNetworkWS ; + hmas:isMaterialOf ex:TOD_Network ; + hmas:hasProfile ex:GroupBoardProfile. + +## Group board profile +ex:GroupBoardProfile a hmas:ResourceProfile; + hmas:isProfileOf ex:GroupBoard; + hmas:exposesSignifier ex:CreateMembershipSignifier. + +## Signifiers +ex:CreateMembershipSignifier a hmas:Signifier; + hmas:signifies ex:CreateMembership. + +## Action Execution Specifications +ex:CreateMembership a sh:NodeShape ; + rdfs:subClassOf hmas:ActionExecution ; + sh:property [ + sh:path prov:used ; + sh:hasValue ex:HTTPForm3 ; + ] ; + sh:property [ + sh:path hmas:hasInput; + sh:qualifiedValueShape ex:MembershipInput ; + sh:qualifiedMinCount 1 ; + sh:qualifiedMaxCount 1 ; + ] . + +## Forms +ex:HTTPForm3 a hctl:Form ; + hctl:target ; + hctl:forContentType "application/json" ; + htv:methodName "POST". + +ex:MembershipInput a sh:NodeShape ; + rdfs:subClassOf hmas:Input, ex:OnlineDisinformationTacklingMembership ; + sh:property [ + sh:path [ sh:inversePath rdf:type ] ; + sh:minCount 1 ; + sh:maxCount 1 ; + ] . From b71673f30fda3fdfa61ab4cc954dc2816662f430 Mon Sep 17 00:00:00 2001 From: danaivach Date: Thu, 15 Jun 2023 20:03:06 +0200 Subject: [PATCH 04/12] Create README.md --- .../tackling-online-disinformation/join-organization/README.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 domains/tackling-online-disinformation/join-organization/README.md diff --git a/domains/tackling-online-disinformation/join-organization/README.md b/domains/tackling-online-disinformation/join-organization/README.md new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/domains/tackling-online-disinformation/join-organization/README.md @@ -0,0 +1 @@ + From 7cceb9a90941f96dd6b7699258eee85c522e71e3 Mon Sep 17 00:00:00 2001 From: danaivach Date: Thu, 15 Jun 2023 21:30:29 +0200 Subject: [PATCH 05/12] add description --- .../join-organization/README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/domains/tackling-online-disinformation/join-organization/README.md b/domains/tackling-online-disinformation/join-organization/README.md index 8b137891..32139e7e 100644 --- a/domains/tackling-online-disinformation/join-organization/README.md +++ b/domains/tackling-online-disinformation/join-organization/README.md @@ -1 +1,7 @@ +# Join an Organization + +## Description +Alice had decided to copy the DPr Network's organizational model to create the TOD organization. The creation of the TOD organization has been reflected in the hypermedia environment with the creation of an organization board artifact that can be used to enter and manage the organization. The organization board artifact is a material of the TOD organization, and it is contained in the News Network workspace, a shared space for news network members. While situated in the same workspace, Carol noticed the organization board artifact and decided to join the TOD organization to contribute to its mission of tackling online disinformation. Upon examining the artifact's profile, Carol perceives information about how to join the organization, which involves providing an API key for accessing the annotating service facility of the TOD organization. She proceeds to interact with the organization board artifact providing an API key, that unlocks new possible interactions for Carol with the organization. + +Carol has an article published online that she wants to evaluate. Therefore, she decides to create a group so that she can become a member of a tackling online disinformation team for that article. First, she interacts with the organization board artifact to create such a team based on information that she discovers on the artifact's profile. The creation of the tackling disinformation team is reflected in the hypermedia environment with the creation of a group board artifact that can be used to manage the new team. Then, Carol interacts with the group board artifact to become a member of the team as a general evaluator, based on information that she discovers on the group board artifact's profile. From 2ccb59032fcc0cce8f45edaa25ab3d596bcae6b5 Mon Sep 17 00:00:00 2001 From: danaivach Date: Fri, 16 Jun 2023 07:01:54 +0200 Subject: [PATCH 06/12] add competency questions --- .../join-organization/README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/domains/tackling-online-disinformation/join-organization/README.md b/domains/tackling-online-disinformation/join-organization/README.md index 32139e7e..65090bbb 100644 --- a/domains/tackling-online-disinformation/join-organization/README.md +++ b/domains/tackling-online-disinformation/join-organization/README.md @@ -5,3 +5,16 @@ Alice had decided to copy the DPr Network's organizational model to create the T Carol has an article published online that she wants to evaluate. Therefore, she decides to create a group so that she can become a member of a tackling online disinformation team for that article. First, she interacts with the organization board artifact to create such a team based on information that she discovers on the artifact's profile. The creation of the tackling disinformation team is reflected in the hypermedia environment with the creation of a group board artifact that can be used to manage the new team. Then, Carol interacts with the group board artifact to become a member of the team as a general evaluator, based on information that she discovers on the group board artifact's profile. +## Competency Questions + +| ID | Question in Natural Language | Example | +|----|------------------------------|---------| +| q1 | What are the artifacts contained in a workspace X? | What are the artifacts contained in the News Network workspace? `ex:AnnotatingService`, `ex:OrganizationBoard`| +| q2 | Of what organizations is an artifact X a material? | Of what organizations if the organization board artifact a material? `ex:TOD_Network` | +| q3 | What is the profile of an artifact X ? | What is the profile of the organization board artifact? `ex:OrganizationBoardProfile` | +| q4 | What are the signifiers exposed in a profile X? | What are the signifiers exposed in the profile of the organization board artifact? `ex:EnterOrganizationSignifier`, `ex:CreateGroupSignifier` | +| q5 | What is the specification of an action execution signified by a signifier X? | What is the specification of an action execution signified by `ex:EnterOrganizationSignifier`? `ex:EnterOrganization` | +| q6 | What are the forms in a specification of an action execution X? | What are the forms in `ex:EnterOrganization`? `ex:HTTPForm1` | +| q7 | What is the input specification in a specification of an action execution X? | What is the input specification in a specification of an action execution X? `ex:Credentials` | + + From 48ea91dfef32c45696536980ed3577454de98a24 Mon Sep 17 00:00:00 2001 From: danaivach Date: Mon, 19 Jun 2023 17:22:50 +0200 Subject: [PATCH 07/12] update joining process --- .../join-organization/README.md | 30 ++++++++++++------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/domains/tackling-online-disinformation/join-organization/README.md b/domains/tackling-online-disinformation/join-organization/README.md index 65090bbb..99ce328e 100644 --- a/domains/tackling-online-disinformation/join-organization/README.md +++ b/domains/tackling-online-disinformation/join-organization/README.md @@ -1,20 +1,28 @@ # Join an Organization ## Description -Alice had decided to copy the DPr Network's organizational model to create the TOD organization. The creation of the TOD organization has been reflected in the hypermedia environment with the creation of an organization board artifact that can be used to enter and manage the organization. The organization board artifact is a material of the TOD organization, and it is contained in the News Network workspace, a shared space for news network members. While situated in the same workspace, Carol noticed the organization board artifact and decided to join the TOD organization to contribute to its mission of tackling online disinformation. Upon examining the artifact's profile, Carol perceives information about how to join the organization, which involves providing an API key for accessing the annotating service facility of the TOD organization. She proceeds to interact with the organization board artifact providing an API key, that unlocks new possible interactions for Carol with the organization. +Alice had decided to use the News Network organizational model to enact the TOD organization. In this case, the enactment of the TOD organization has been reflected in the hypermedia environment with the creation of an organization board artifact that can be used to enter and manage the organization. The organization board artifact is a material of the TOD organization, and it is contained in the News Network workspace. -Carol has an article published online that she wants to evaluate. Therefore, she decides to create a group so that she can become a member of a tackling online disinformation team for that article. First, she interacts with the organization board artifact to create such a team based on information that she discovers on the artifact's profile. The creation of the tackling disinformation team is reflected in the hypermedia environment with the creation of a group board artifact that can be used to manage the new team. Then, Carol interacts with the group board artifact to become a member of the team as a general evaluator, based on information that she discovers on the group board artifact's profile. +While situated in the same workspace, Carol notices the organization board artifact and decides to enter the TOD organization to contribute in tackling online disinformation. Upon examining the artifact's profile, Carol perceives information about how to execute an action to enact a membership, and therefore, to become an active user in the organization's group of active users. As the TOD organization maintains an open and inclusive approach, Carol is able to directly enact the membership without having to undergo a specific application process, despite it being her first interaction with the organization. + +Being now a member of the TOD organization, Carol decides to evaluate the content of an article that she read on the Web, and, therefore, to enact an article evaluation group so that she can contribute her evaluation along with other members of the organization. For this, she interacts with the organization board artifact to enact such a group based on information that she discovers on the artifact's profile. The enactment of the article evaluation group is reflected in the hypermedia environment with the creation of a group board artifact, that is a material of the TOD organization, is contained in the News Network workspace, and can be used to manage the new group. + +Agents that enact memberships in the new article evaluation group can contribute to the evaluation of an article. Associated to this group, the TOD organization defines the following set of positions: ++ _Article General Evaluator_: Annotate the article based on the article's general impression. ++ _Article General Investigator_: Annotate the article based on the article's credibility rating, publishers, authors etc. ++ _Article Media Investigator_: Annotate the article based on the original sources of its images. ++ _Article Aggrecator_: Annotate the article based on aggregated evaluations to give a summarized overview of the evaluation results + +Upon examining the group board artifact's profile, Carol perceives information about how to execute an action to enact a memebership in the new group, and therefore take over one of the positions. Carol enacts the article general evaluator membership to become a general evaluator in the new article evaluation group. ## Competency Questions | ID | Question in Natural Language | Example | |----|------------------------------|---------| -| q1 | What are the artifacts contained in a workspace X? | What are the artifacts contained in the News Network workspace? `ex:AnnotatingService`, `ex:OrganizationBoard`| -| q2 | Of what organizations is an artifact X a material? | Of what organizations if the organization board artifact a material? `ex:TOD_Network` | -| q3 | What is the profile of an artifact X ? | What is the profile of the organization board artifact? `ex:OrganizationBoardProfile` | -| q4 | What are the signifiers exposed in a profile X? | What are the signifiers exposed in the profile of the organization board artifact? `ex:EnterOrganizationSignifier`, `ex:CreateGroupSignifier` | -| q5 | What is the specification of an action execution signified by a signifier X? | What is the specification of an action execution signified by `ex:EnterOrganizationSignifier`? `ex:EnterOrganization` | -| q6 | What are the forms in a specification of an action execution X? | What are the forms in `ex:EnterOrganization`? `ex:HTTPForm1` | -| q7 | What is the input specification in a specification of an action execution X? | What is the input specification in a specification of an action execution X? `ex:Credentials` | - - +| q1 | What are the artifacts contained in given workspace? | What are the artifacts contained in the News Network workspace? `ex:AnnotatingService`, `ex:OrganizationBoard`, `ex:GroupBoard` | +| q2 | Of what organizations is given artifact a material? | Of what organizations is the organization board artifact a material? `ex:TOD_Network` | +| q3 | What is the profile of given artifact? | What is the profile of the organization board artifact? `ex:OrganizationBoardProfile` | +| q4 | What are the signifiers exposed in a given profile? | What are the signifiers exposed in the profile of the organization board artifact? `ex:EnterOrganizationSignifier`, `ex:CreateGroupSignifier` | +| q5 | What is the specification of an action execution signified by a given signifier? | What is the specification of an action execution signified by `ex:EnterOrganizationSignifier`? `ex:EnterOrganization` | +| q6 | What are the forms in a given specification of an action execution? | What are the forms in the specification `ex:EnterOrganization`? `ex:HTTPForm1` | +| q7 | What is the input specification in a given specification of an action execution? | What is the input specification in the specification `ex:EnterOrganization`? `ex:Credentials` | From 663c2790a22d2a9ac7b1bd4d4f80e19b819b07aa Mon Sep 17 00:00:00 2001 From: danaivach Date: Mon, 19 Jun 2023 17:30:40 +0200 Subject: [PATCH 08/12] image investigator to media investigator --- .../join-organization/dataset.ttl | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/domains/tackling-online-disinformation/join-organization/dataset.ttl b/domains/tackling-online-disinformation/join-organization/dataset.ttl index 6443dc31..55e3ac0e 100644 --- a/domains/tackling-online-disinformation/join-organization/dataset.ttl +++ b/domains/tackling-online-disinformation/join-organization/dataset.ttl @@ -101,7 +101,7 @@ ex:NewsNetwork a sh:NodeShape ; ] ; sh:property [ sh:path hmas:providesRole ; - sh:qualifiedValueShape [ sh:class ex:ImageInvestigator ] ; + sh:qualifiedValueShape [ sh:class ex:MediaInvestigator ] ; sh:qualifiedMinCount 1 ; sh:qualifiedMaxCount 1 ; ] ; @@ -159,7 +159,7 @@ ex:NewsNetwork a sh:NodeShape ; sh:qualifiedMinCount 1 ; sh:qualifiedMaxCount 1 ; ] ; - sh:property [ + sh:property [ sh:path hmas:proposesFacility ; sh:qualifiedValueShape [ sh:class ex:NewsNetworkOrganizationBoard ] ; sh:qualifiedMinCount 1 ; @@ -192,7 +192,7 @@ ex:GeneralEvaluator a sh:NodeShape ; rdfs:subClassOf hmas:Journalist . ex:GeneralInvestigator a sh:NodeShape ; rdfs:subClassOf hmas:Journalist . -ex:ImageInvestigator a sh:NodeShape ; +ex:MediaInvestigator a sh:NodeShape ; rdfs:subClassOf hmas:Journalist . ex:Admin a sh:NodeShape ; rdfs:subClassOf hmas:Role . @@ -263,7 +263,7 @@ ex:TOD_ActiveUser a ex:ActiveUser . ex:TOD_Journalist a ex:Journalist . ex:TOD_GeneralEvaluator a ex:GeneralEvaluator . ex:TOD_GeneralInvestigator a ex:GeneralInvestigator . -ex:TOD_ImageInvestigator a ex:ImageInvestigator . +ex:TOD_MediaInvestigator a ex:MediaInvestigator . ex:TOD_Admin a ex:Admin . ex:TOD_Aggregator a ex:Aggregator . ex:TOD_Control a ex:Control . @@ -288,7 +288,7 @@ ex:TOD_NetworkProfile a hmas:ResourceProfile; ex:TOD_Network a ex:NewsNetwork ; hmas:hasProfile ex:TOD_NetworkProfile ; hmas:hasOrganizationalValue ex:TOD_Accountability, ex:TOD_Transparency ; - hmas:providesRole ex:TOD_ActiveUser, ex:TOD_Journalist, ex:TOD_GeneralEvaluator, ex:TOD_GeneralInvestigator, ex:TOD_ImageInvestigator, ex:TOD_Admin, ex:TOD_Aggregator, ex:TOD_Contol; + hmas:providesRole ex:TOD_ActiveUser, ex:TOD_Journalist, ex:TOD_GeneralEvaluator, ex:TOD_GeneralInvestigator, ex:TOD_MediaInvestigator, ex:TOD_Admin, ex:TOD_Aggregator, ex:TOD_Contol; hmas:proposesMission ex:TOD_ContentEvaluationMission, ex:TOD_ArticleCredibilityMission, ex:TOD_ImageProvenanceMission, ex:TOD_SystemFunctionalityMission, ex:TOD_ControlMission ; hmas:proposesFacility ex:TOD_NewsNetworkAnnotatingService, ex:TOD_NewsNetworkOrganizationBoard . From 9a6e89072d541dde4bf0f156dd3921de6eea0907 Mon Sep 17 00:00:00 2001 From: danaivach Date: Mon, 19 Jun 2023 18:10:08 +0200 Subject: [PATCH 09/12] update org signifiers --- .../join-organization/dataset.ttl | 211 +++++++++++------- 1 file changed, 134 insertions(+), 77 deletions(-) diff --git a/domains/tackling-online-disinformation/join-organization/dataset.ttl b/domains/tackling-online-disinformation/join-organization/dataset.ttl index 55e3ac0e..3fbfa70f 100644 --- a/domains/tackling-online-disinformation/join-organization/dataset.ttl +++ b/domains/tackling-online-disinformation/join-organization/dataset.ttl @@ -187,17 +187,17 @@ ex:Transparency a sh:NodeShape ; ex:ActiveUser a sh:NodeShape ; rdfs:subClassOf hmas:Role . ex:Journalist a sh:NodeShape ; - rdfs:subClassOf hmas:ActiveUser . + rdfs:subClassOf ex:ActiveUser . ex:GeneralEvaluator a sh:NodeShape ; - rdfs:subClassOf hmas:Journalist . + rdfs:subClassOf ex:Journalist . ex:GeneralInvestigator a sh:NodeShape ; - rdfs:subClassOf hmas:Journalist . + rdfs:subClassOf ex:Journalist . ex:MediaInvestigator a sh:NodeShape ; - rdfs:subClassOf hmas:Journalist . + rdfs:subClassOf ex:Journalist . ex:Admin a sh:NodeShape ; rdfs:subClassOf hmas:Role . ex:Agreegator a sh:NodeShape ; - rdfs:subClassOf hmas:Admin . + rdfs:subClassOf ex:Admin . ex:Control a sh:NodeShape ; rdfs:subClassOf hmas:Role . @@ -216,17 +216,78 @@ ex:ControlMission a sh:NodeShape ; ## Facilities ex:NewsNetworkAnnotatingService a sh:NodeShape ; rdfs:subClassOf hmas:Facility . -ex:NewsNetworkOrganizationBoard a sh:NodeShape ; - rdfs:subClassOf hmas:Facility . -ex:NewsNetworkGroupBoard a sh:NodeShape ; - rdfs:subClassOf hmas:Facility . ## Group -ex:OnlineDisinformationTacklingTeam a sh:NodeShape ; +ex:ActiveUsers a sh:NodeShape ; + rdfs:subClassOf hmas:Group . +ex:ArticleEvaluators a sh:NodeShape ; rdfs:subClassOf hmas:Group . ## Membership -ex:OnlineDisinformationTacklingMembership a sh:NodeShape ; +ex:ActiveUserMembership a sh:NodeShape ; + rdfs:subClassOf hmas:Membership ; + sh:property [ + sh:path hmas:isMembershipOf ; + sh:qualifiedValueShape [ sh:class hmas:Agent ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipFor ; + sh:qualifiedValueShape [ sh:class ex:ActiveUser ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipIn ; + sh:qualifiedValueShape [ sh:class ex:ActiveUsers ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] . + +ex:ArticleGeneralEvaluatorMembership a sh:NodeShape ; + rdfs:subClassOf hmas:Membership ; + sh:property [ + sh:path hmas:isMembershipOf ; + sh:qualifiedValueShape [ sh:class hmas:Agent ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipFor ; + sh:qualifiedValueShape [ sh:class ex:GeneralEvaluator ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipIn ; + sh:qualifiedValueShape [ sh:class ex:ArticleEvaluators ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] . + +ex:ArticleGeneralInvestigatorMembership a sh:NodeShape ; + rdfs:subClassOf hmas:Membership ; + sh:property [ + sh:path hmas:isMembershipOf ; + sh:qualifiedValueShape [ sh:class hmas:Agent ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipFor ; + sh:qualifiedValueShape [ sh:class ex:GeneralInvestigator ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipIn ; + sh:qualifiedValueShape [ sh:class ex:ArticleEvaluators ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] . + +ex:ArticleMediaInvestigatorMembership a sh:NodeShape ; rdfs:subClassOf hmas:Membership ; sh:property [ sh:path hmas:isMembershipOf ; @@ -236,13 +297,34 @@ ex:OnlineDisinformationTacklingMembership a sh:NodeShape ; ] ; sh:property [ sh:path hmas:isMembershipFor ; - sh:qualifiedValueShape [ sh:class hmas:Role ] ; + sh:qualifiedValueShape [ sh:class ex:MediaInvestigator ] ; sh:quantifiedMinCount 1 ; sh:quantifiedMaxCount 1 ; ] ; sh:property [ sh:path hmas:isMembershipIn ; - sh:qualifiedValueShape [ sh:class ex:OnlineDisinformationTacklingTeam ] ; + sh:qualifiedValueShape [ sh:class ex:ArticleEvaluators ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] . + +ex:ArticleAggregatorMembership a sh:NodeShape ; + rdfs:subClassOf hmas:Membership ; + sh:property [ + sh:path hmas:isMembershipOf ; + sh:qualifiedValueShape [ sh:class hmas:Agent ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipFor ; + sh:qualifiedValueShape [ sh:class ex:Aggregator ] ; + sh:quantifiedMinCount 1 ; + sh:quantifiedMaxCount 1 ; + ] ; + sh:property [ + sh:path hmas:isMembershipIn ; + sh:qualifiedValueShape [ sh:class ex:ArticleEvaluators ] ; sh:quantifiedMinCount 1 ; sh:quantifiedMaxCount 1 ; ] . @@ -255,7 +337,7 @@ ex:TOD_Transparency a ex:Transparency . # Groups ## Groups -ex:TOD_OnlineDisinformationTacklingTeam a ex:OnlineDisinformationTacklingTeam ; +ex:TOD_ActiveUsers a ex:ActiveUsers ; hmas:structures ex:TOD_Network . ## Roles @@ -297,124 +379,99 @@ ex:TOD_Network a ex:NewsNetwork ; ################################################################# ## Organization board profile -ex:OrganizationBoardProfile a hmas:ResourceProfile; +ex:organizationBoardProfile a hmas:ResourceProfile; hmas:isProfileOf ex:OrganizationBoard; - hmas:exposesSignifier ex:EnterOrganizationSignifier, ex:CreateGroupSignifier. + hmas:exposesSignifier ex:enactActiveUserMembershipSignifier, ex:enactGroupSignifier. ## Signifiers -ex:EnterSignifier a hmas:Signifier; - hmas:signifies ex:EnterOrganization. -ex:CreateGroupSignifier a hmas:Signifier; - hmas:signifies ex:CreateGroup. +ex:enactActiveUserMembershipSignifier a hmas:Signifier; + hmas:signifies ex:EnactActiveUserMembership. +ex:enactGroupSignifier a hmas:Signifier; + hmas:signifies ex:EnactGroup. ## Action Execution Specifications -ex:EnterOrganization a sh:NodeShape ; +ex:EnactActiveUserMembership a sh:NodeShape ; rdfs:subClassOf hmas:ActionExecution ; sh:property [ sh:path prov:used ; - sh:hasValue ex:HTTPForm1 ; + sh:hasValue ex:httpForm1 ; ] ; sh:property [ sh:path hmas:hasInput; - sh:qualifiedValueShape ex:Credentials ; + sh:qualifiedValueShape [ sh:class ex:ActiveUserMembership ] ; sh:qualifiedMinCount 1 ; sh:qualifiedMaxCount 1 ; ] . -ex:CreateGroup a sh:NodeShape ; +ex:EnactGroup a sh:NodeShape ; rdfs:subClassOf hmas:ActionExecution ; sh:property [ sh:path prov:used ; - sh:hasValue ex:HTTPForm2 ; + sh:hasValue ex:httpForm2 ; ] ; sh:property [ sh:path hmas:hasInput; - sh:qualifiedValueShape ex:Credentials ; + sh:qualifiedValueShape [ + sh:or ( # this is not validated properly + [ sh:class ex:ActiveUsers ] + [ sh:class ex:ArticleEvaluators ] + ) + ] ; sh:qualifiedMinCount 1 ; sh:qualifiedMaxCount 1 ; ] . ## Forms -ex:HTTPForm1 a hctl:Form ; - hctl:target ; +ex:httpForm1 a hctl:Form ; + hctl:target ; hctl:forContentType "application/json" ; htv:methodName "POST". -ex:HTTPForm2 a hctl:Form ; +ex:httpForm2 a hctl:Form ; hctl:target ; hctl:forContentType "application/json" ; htv:methodName "POST". -## Input Specifications -ex:Credentials a sh:NodeShape ; - rdfs:subClassOf hmas:Input ; - sh:property [ - sh:path [ sh:inversePath rdf:type ] ; - sh:minCount 1 ; - sh:maxCount 1 ; - ] ; - sh:property [ - sh:path ex:hasHypothesisAPIKey ; - sh:qualifiedValueShape xs:string ; - sh:qualifiedMinCount 1 ; - sh:qualifiedMaxCount 1 ; - ] . - -ex:GroupInput a sh:NodeShape ; - rdfs:subClassOf hmas:Input ; - sh:property [ - sh:path [ sh:inversePath rdf:type ] ; - sh:minCount 1 ; - sh:maxCount 1 ; - ] ; - sh:property [ - sh:path ex:hasGroupClass ; - sh:qualifiedValueShape hmas:Group ; - sh:qualifiedMinCount 1 ; - sh:qualifiedMaxCount 1 ; - ] . - ## GROUP BOARD INITIALIZATION ex:NewsNetworkWS hmas:contains ex:GroupBoard. -ex:GroupBoard a hmas:Artifact ; +ex:groupBoard a hmas:Artifact ; hmas:isContainedIn ex:NewsNetworkWS ; hmas:isMaterialOf ex:TOD_Network ; - hmas:hasProfile ex:GroupBoardProfile. + hmas:hasProfile ex:groupBoardProfile. ## Group board profile -ex:GroupBoardProfile a hmas:ResourceProfile; - hmas:isProfileOf ex:GroupBoard; - hmas:exposesSignifier ex:CreateMembershipSignifier. +ex:groupBoardProfile a hmas:ResourceProfile; + hmas:isProfileOf ex:groupBoard; + hmas:exposesSignifier ex:enactMembershipSignifier. ## Signifiers -ex:CreateMembershipSignifier a hmas:Signifier; - hmas:signifies ex:CreateMembership. +ex:enactMembershipSignifier a hmas:Signifier; + hmas:signifies ex:EnactMembership. ## Action Execution Specifications -ex:CreateMembership a sh:NodeShape ; +ex:EnactMembership a sh:NodeShape ; rdfs:subClassOf hmas:ActionExecution ; sh:property [ sh:path prov:used ; - sh:hasValue ex:HTTPForm3 ; + sh:hasValue ex:httpForm3 ; ] ; sh:property [ sh:path hmas:hasInput; - sh:qualifiedValueShape ex:MembershipInput ; + sh:qualifiedValueShape [ + sh:or ( # this is not validated properly + [ sh:class ex:ArticleGeneralEvaluatorMembership ] + [ sh:class ex:ArticleGeneralInvestigatorMembership ] + [ sh:class ex:ArticleMediaInvestigatorMembership ] + [ sh:class ex:ArticleAggregatorMembership ] + ) + ] ; sh:qualifiedMinCount 1 ; sh:qualifiedMaxCount 1 ; ] . ## Forms -ex:HTTPForm3 a hctl:Form ; +ex:httpForm3 a hctl:Form ; hctl:target ; hctl:forContentType "application/json" ; htv:methodName "POST". - -ex:MembershipInput a sh:NodeShape ; - rdfs:subClassOf hmas:Input, ex:OnlineDisinformationTacklingMembership ; - sh:property [ - sh:path [ sh:inversePath rdf:type ] ; - sh:minCount 1 ; - sh:maxCount 1 ; - ] . From a4aafea9a9a4dac3a723ee488df0e2d15fc20d90 Mon Sep 17 00:00:00 2001 From: danaivach Date: Mon, 19 Jun 2023 18:14:51 +0200 Subject: [PATCH 10/12] update question examples --- .../join-organization/README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/domains/tackling-online-disinformation/join-organization/README.md b/domains/tackling-online-disinformation/join-organization/README.md index 99ce328e..d2ddc7b7 100644 --- a/domains/tackling-online-disinformation/join-organization/README.md +++ b/domains/tackling-online-disinformation/join-organization/README.md @@ -19,10 +19,10 @@ Upon examining the group board artifact's profile, Carol perceives information a | ID | Question in Natural Language | Example | |----|------------------------------|---------| -| q1 | What are the artifacts contained in given workspace? | What are the artifacts contained in the News Network workspace? `ex:AnnotatingService`, `ex:OrganizationBoard`, `ex:GroupBoard` | +| q1 | What are the artifacts contained in given workspace? | What are the artifacts contained in the News Network workspace? `ex:AnnotatingService`, `ex:organizationBoard`, `ex:groupBoard` | | q2 | Of what organizations is given artifact a material? | Of what organizations is the organization board artifact a material? `ex:TOD_Network` | | q3 | What is the profile of given artifact? | What is the profile of the organization board artifact? `ex:OrganizationBoardProfile` | -| q4 | What are the signifiers exposed in a given profile? | What are the signifiers exposed in the profile of the organization board artifact? `ex:EnterOrganizationSignifier`, `ex:CreateGroupSignifier` | -| q5 | What is the specification of an action execution signified by a given signifier? | What is the specification of an action execution signified by `ex:EnterOrganizationSignifier`? `ex:EnterOrganization` | -| q6 | What are the forms in a given specification of an action execution? | What are the forms in the specification `ex:EnterOrganization`? `ex:HTTPForm1` | -| q7 | What is the input specification in a given specification of an action execution? | What is the input specification in the specification `ex:EnterOrganization`? `ex:Credentials` | +| q4 | What are the signifiers exposed in a given profile? | What are the signifiers exposed in the profile of the organization board artifact? `ex:EnactActiveUserMembershipSignifier`, `ex:EnactGroupSignifier` | +| q5 | What is the specification of an action execution signified by a given signifier? | What is the specification of an action execution signified by `ex:EnactActiveUserMembershipSignifier`? `ex:EnactActiveUserMembership` | +| q6 | What are the forms in a given specification of an action execution? | What are the forms in the specification `ex:EnactActiveUserMembership`? `ex:httpForm1` | +| q7 | What is the input specification in a given specification of an action execution? | What is the input specification in the specification ex:EnactActiveUserMembership`? `ex:ActiveUsers`, `ex:ArticleEvaluators ` | From ff35139124230bd85d779b84328c879fe5ae5ff2 Mon Sep 17 00:00:00 2001 From: danaivach Date: Mon, 19 Jun 2023 18:15:17 +0200 Subject: [PATCH 11/12] fix typo --- .../tackling-online-disinformation/join-organization/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/domains/tackling-online-disinformation/join-organization/README.md b/domains/tackling-online-disinformation/join-organization/README.md index d2ddc7b7..f47d63a4 100644 --- a/domains/tackling-online-disinformation/join-organization/README.md +++ b/domains/tackling-online-disinformation/join-organization/README.md @@ -25,4 +25,4 @@ Upon examining the group board artifact's profile, Carol perceives information a | q4 | What are the signifiers exposed in a given profile? | What are the signifiers exposed in the profile of the organization board artifact? `ex:EnactActiveUserMembershipSignifier`, `ex:EnactGroupSignifier` | | q5 | What is the specification of an action execution signified by a given signifier? | What is the specification of an action execution signified by `ex:EnactActiveUserMembershipSignifier`? `ex:EnactActiveUserMembership` | | q6 | What are the forms in a given specification of an action execution? | What are the forms in the specification `ex:EnactActiveUserMembership`? `ex:httpForm1` | -| q7 | What is the input specification in a given specification of an action execution? | What is the input specification in the specification ex:EnactActiveUserMembership`? `ex:ActiveUsers`, `ex:ArticleEvaluators ` | +| q7 | What is the input specification in a given specification of an action execution? | What is the input specification in the specification ex:EnactActiveUserMembership? `ex:ActiveUsers`, `ex:ArticleEvaluators` | From 49649110b6cc97d1f1fdeecce1cc1307798fb62c Mon Sep 17 00:00:00 2001 From: danaivach Date: Mon, 19 Jun 2023 18:44:56 +0200 Subject: [PATCH 12/12] add recommendations --- .../join-organization/README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/domains/tackling-online-disinformation/join-organization/README.md b/domains/tackling-online-disinformation/join-organization/README.md index f47d63a4..12990ad1 100644 --- a/domains/tackling-online-disinformation/join-organization/README.md +++ b/domains/tackling-online-disinformation/join-organization/README.md @@ -24,5 +24,11 @@ Upon examining the group board artifact's profile, Carol perceives information a | q3 | What is the profile of given artifact? | What is the profile of the organization board artifact? `ex:OrganizationBoardProfile` | | q4 | What are the signifiers exposed in a given profile? | What are the signifiers exposed in the profile of the organization board artifact? `ex:EnactActiveUserMembershipSignifier`, `ex:EnactGroupSignifier` | | q5 | What is the specification of an action execution signified by a given signifier? | What is the specification of an action execution signified by `ex:EnactActiveUserMembershipSignifier`? `ex:EnactActiveUserMembership` | -| q6 | What are the forms in a given specification of an action execution? | What are the forms in the specification `ex:EnactActiveUserMembership`? `ex:httpForm1` | +| q6 | What are the forms in a given specification of an action execution? | What are the forms in the specification `ex:EnactActiveUserMembership`? `ex:httpForm1` | | q7 | What is the input specification in a given specification of an action execution? | What is the input specification in the specification ex:EnactActiveUserMembership? `ex:ActiveUsers`, `ex:ArticleEvaluators` | + +## Recommendations ++ In the hypermedia environment, diverse entities, such as agents that are members and artifacts that are materials of an organization, can provide interaction possibilities to enable agents' interaction with the organization. ++ Agents have the flexibility to join organizations through various processes determined by the organization designers, which may involve: + + The submission of an application for joining the organization, subject to evaluation, acceptance, or rejection by the organization authorities. Upon acceptance, the agent becomes a member of the organization, and gains the ability to interact with the organization, such as enacting a membership. + + Alternatively, in implicit application processes, agents enter the organization upon interacting towards contributing as members, for instance, by enacting a membership or committing to a mission.