Content of a GOVERNANCE.md file ?

[maximelefrancois86]

The following questions are taken from one of the slides of the FAIR-IMPACT's Semantic Artefact Governance Workshop

The suggestions would be to make sure that answers to these questions are available as part of the README.md file of the repository, or a dedicated file GOVERNANCE.md

Q1: Context / Principles

• Goals of the Infrastructure/Project/Research entity ?
• What is the nature of the semantic artefacts and where and from whom do they come?
• Is your group of semantic artefacts hosted by one or several semantic artefact catalogues? Are those catalogues part of your publication processes?

Q2: Metadata

• Which information do you require to describe your semantic artefacts?
• Which metadata standards do you use?

Q3: Quality

• How do you assure the quality of your semantic artefacts?
• What are the recommended good practices? Are you following guidelines or high level principles?
• Do you enforce reuses and imports from other semantic artefacts?
• How do you collect feedback and issues from the users?

Q4: Access

• Do you have terms and conditions for your semantic artefacts and who is responsible? How are they licensed?
• Do you have machine accessible endpoints available? Other services to share/support the ontologies?
• How do you communicate with semantic artefact users and get them notified?
• How do you ensure the sustainability of your semantic artefacts? (financially speaking but not only)

Q5: Lifecycle

• How do you deal with the maintenance? Describe the processes to add new terms (method, periodicity and policy)?
• How do you deal with retirement or obsolescence?
• How do you manage the versioning?
• Do you manage different languages (for labels)?

Q6: Stakeholders and decisions

• Can you list the stakeholders involved in each of these governance aspects? (developper, curator, board, experts, committee…)?
• How are you taking decisions for each of the governance workflow steps?