Skip to content

Commit 97b9546

Browse files
pfabrymatentzn
andauthored
Update RoleNORManager.md (#2248)
* Update RoleNORManager.md * Update docs/roles/RoleNORManager.md * Update RoleNORManager.md Added the requestors need to join obo-discuss and Slack. * Update RoleNORManager.md Valid link for new ontology submission template Co-authored-by: Nico Matentzoglu <nicolas.matentzoglu@gmail.com>
1 parent 392f9e8 commit 97b9546

1 file changed

Lines changed: 27 additions & 7 deletions

File tree

docs/roles/RoleNORManager.md

Lines changed: 27 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,24 @@ title: New Ontology Request (NOR) Manager
66

77
The New Ontology Request (NOR) Manager has these basic duties:
88

9-
1. Receiving `new ontology` requests on OBO and acknowledging the receipt
10-
2. Including the ontology in the OBO New Ontology Request (NOR) Dashboard
9+
1. Receiving `new ontology` requests on the OBO Foundry GitHub issues tracker and acknowledging the receipt
10+
2. Including the ontology in the OBO New Ontology Request (NOR) Dashboard and updating the dashboard
1111
3. Supporting the New Ontology requestor to pass the OBO Dashboard
1212
4. Assigning a provisional reviewer from the OBO Operations Committee
1313
5. Removing the accepted ontology from the NOR Dashboard upon acceptance
1414

1515

1616
### Receiving `new ontology` requests on OBO and acknowledging the receipt
1717

18-
- The NOR Manager MUST actively listen to issues on the [OBO Issue Tracker](https://github.com/OBOFoundry/OBOFoundry.github.io/issues).
19-
- When a new ontology request is received, and the wrong issue template was used, the New Ontology Request (NOR) Manager must inform the NOR requestor to use the correct issue template and close the wrongly submitted issue.
18+
- The NOR Manager MUST actively listen to issues on the [OBOFoundry GitHub issues tracker](https://github.com/OBOFoundry/OBOFoundry.github.io/issues).
19+
- When a new ontology request is received, and the wrong issue template was used, the NOR Manager must inform the NOR requestor to use the correct issue template and close the wrongly submitted issue with the following message:
20+
```markdown
21+
Dear @GITHUBNAME,
22+
23+
Thank you for your submission.
24+
However, the wrong issue template has been used. Please make sure to follow the [New Ontology Submission Instructions](https://obofoundry.org/docs/NewOntologyRegistrationInstructions.html) and use the [New Ontology Request issue template](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/new?assignees=&labels=new+ontology&template=new-ontology.yml&title=Request+for+new+ontology+%5BNAME%5D).
25+
Thank you.
26+
```
2027
- When a valid NOR request is received the NOR Manager acknowledges the receipt with the following message:
2128
```markdown
2229
Dear @GITHUBNAME,
@@ -38,14 +45,27 @@ The New Ontology Request (NOR) Manager has these basic duties:
3845

3946
Good luck.
4047
```
48+
- The NOR Manager must ensure that the requestors use the proper communication channels with the OBO community:
49+
- Make sure that the requestors have joined and send an appropriate email to the obo-discuss mailing list (see the [FAQ](https://obofoundry.org/faq/how-do-i-register-my-ontology.html)). If they have not, point them to the instructions and ask them to do so.
50+
- Invite the requestors (using the email listed in the metadata) to the OBO Foundry Slack space (using the `Slack->Invite people to obo-community` menu, adding the email provided.
4151

42-
### Including the ontology into the OBO New Ontology Request (NOR) Dashboard
52+
### Including the ontology into the OBO New Ontology Request (NOR) Dashboard and updating the dashboard
4353

4454
The OBO NOR Dashboard is managed here: https://github.com/OBOFoundry/obo-nor.github.io.
4555

4656
Integrating the submitted ontology into OBO dashboard means simply adding a new record into the `ontologies->custom` subsection
47-
of the [dashboard config file](https://github.com/OBOFoundry/obo-nor.github.io/blob/master/dashboard-config.yml). Only information explicitly mentioned in the New Ontology Request should be used.
48-
- When dashboard config is updated, and every Monday morning, the OBO NOR Dashboard is regenerated using [this](https://github.com/OBOFoundry/obo-nor.github.io/blob/master/.github/workflows/dashboard.yml) GitHub action. The OBO NOR Manager should sanity check the diff for any oddities, in particular, changes to the file `dashboard/dashboard-results.yml`. This PR should always be reviewed by the NOR Manager and not be automatically merged into the main branch as part of the GitHub action.
57+
of the [dashboard config file](https://github.com/OBOFoundry/obo-nor.github.io/blob/master/dashboard-config.yml). Only information explicitly mentioned in the New Ontology Request should be used.
58+
NOTE:
59+
> **All modifications on obo-nor.github.io repository MUST be done via pull requests and NOT via direct commits on the master branch.
60+
> The /workflow/dahsboard.yml file must indicate the GitHubID of the actual NOR manager as assignee.**
61+
62+
Every update (adding or removing an ontology) should proceed as follows:
63+
1. Creation of a Pull Request (PR) for modification of the [dashboard config file](https://github.com/OBOFoundry/obo-nor.github.io/blob/master/dashboard-config.yml) for adding or deleting record in the `ontologies->custom` section of the file.
64+
2. Once the previous PR is merged, it triggers the *Update dashboard run* [GitHub action](https://github.com/OBOFoundry/obo-nor.github.io/blob/master/.github/workflows/dashboard.yml). This action can also be triggered manually [here](https://github.com/OBOFoundry/obo-nor.github.io/actions/workflows/dashboard.yml) with the `run workflow` button.
65+
3. Once the run is complete, a new PR named `Update dashboard run` is created. Manually check the diff, especially the /dashboard/dahsboard-result.yml file for inconsistencies.
66+
4. Finally, merge the `Update dashboard run` PR. This PR should always be reviewed by the NOR Manager and not be automatically merged into the main branch as part of the GitHub action.
67+
68+
In addition, the *Update dashboard run* action is automatically triggered on Monday mornings and steps 3 and 4 must be performed afterward.
4969

5070
### Supporting the New Ontology requestor to pass the OBO Dashboard
5171

0 commit comments

Comments
 (0)