OBOFoundry.github.io icon indicating copy to clipboard operation
OBOFoundry.github.io copied to clipboard

Create a detailed SOP for each role

Open matentzn opened this issue 2 years ago • 5 comments
trafficstars

Currently, only the NOR manager has a detailed role description: https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/docs/roles/RoleNORManager.md

Can we create pages for each new role (make sure correct name from roles.yml)

  • [x] Metadata Manager
  • [ ] TWG Ops Liaison
  • [ ] Dashboard Manager
  • [x] Website Maintainer

And link them using the sop: field in roles.yml?

Everyone should then start fleshing their sop out as we go along during the year.

matentzn avatar Dec 08 '22 15:12 matentzn

Metadata Registry Manager

  • Rules for changing metadata
  • When usages are added, the added usage must be proven by a resolvable link (tested by the Metadata Registry Manager) which resolves to a page which shows evidence of a concrete term from the ontology, such as an identifier, a label, etc.
  • The MRM needs to obtain a review from another member if the TWG for each PR
  • The MRM and only the MRM is allowed to merge metadata related pull requests

matentzn avatar Dec 08 '22 15:12 matentzn

you want me to just come up with something or do you have some text you want me to copy/paste?

erik-whiting avatar Dec 08 '22 16:12 erik-whiting

No for now just empty pages that are formatted analogously to the one I shared.

matentzn avatar Dec 08 '22 16:12 matentzn

Many of these still need to be completed.

nlharris avatar Sep 04 '23 21:09 nlharris

I checked off "Metadata manager" in the list above although the thing I found is called Metadata Steward, not Manager (https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/docs/roles/MetadataSteward.md)

Dashboard Manager is still empty: https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/docs/roles/DashboardManager.md

as is TWG Ops Liaison.

nlharris avatar Feb 07 '24 20:02 nlharris

TWG Ops Liaison page is now done (or will be once the PR is merged).

Are there notes somewhere about the Dashboard Manager role? Maybe @anitacaron knows?

nlharris avatar Jun 25 '25 21:06 nlharris

Oh hey I found some text about Dashboard Manager in https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/_data/roles.yml I will add that to https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/docs/roles/DashboardManager.md

nlharris avatar Jun 25 '25 21:06 nlharris

I noticed that https://github.com/OBOFoundry/OBOFoundry.github.io/edit/master/_data/roles.yml has info about the requirements and duties associated with various roles (which shows up in the website at https://obofoundry.org/roles/overview). This means that roles.yaml is another place where info about roles needs to be updated. So for example I updated DashboardManager.md, but the description of requirements and duties in roles.yml doesn't match that. It's not ideal to have to maintain descriptions in two different places. Could roles.yml instead link to the appropriate page for each role? (Ok, I see it does link to the SOPs, but the description and responsibilities still live in both places. See my PR #2207, which helps to transfer the updates)

nlharris avatar Jun 25 '25 21:06 nlharris