A strawman list of ‘concerns’ relating to the maintenance and governance of FAIR vocabularies was tested and revised in the workshop. A spreadsheet that summarizes the analysis using the vocabulary case-studies is attached.
Attachments |
---|
This table is a snapshot of the consensus at the end of the workshop.
1 | Scope and context | |
1a | What is the vocabulary, its mission/scope What are its application/s or use cases? | |
1b | Vocabulary status | |
1c | Identify
| |
2 | Stakeholders | |
2a | Identify key stakeholders in the vocabulary and their role. Potential roles (definitions by Simon)
N.B.: A stakeholder may play more than one role | ‘Users’ will typically be defined by some intersection of (a) domain or discipline (b) jurisdiction or location (c) economic or organizational sector (d) organization, sub-organizational unit, laboratory, etc (e) project or activity N.B.1: A controlled vocab of roles is needed. Possible inputs: https://zenodo.org/record/4767798#.YVZdSqARXyh compares CREDiT, OBO, DDI, DataCite and ISO roles. MARC relators includes a more comprehensive set of roles N.B.2: Roles may be delegated, including for for subsets or parts of a vocabulary. However, the delegator is still ultimately responsible N.B.3: Roles and stakeholders will evolve if scope evolves |
2b | Identify other stakeholders
| Ben Wu - Consideration here as to the type of user and the style of their approach eg. in data management - security, classification and content vocabularies Anu D - N.B. It may be worthwhile to consider profiling of those stakeholders - for example - what level of technical and content capability is a good examples. Len Smith - Question (flowing from the HASS BoF at eREsearch) - who is, or who should be, responsible for development of standards and vocabularies. Does reflect on the likely contributions and authority structures within a given stakeholder community @Len - that must be a decision for the user community. (If the key user is government (because the codes relate to regulation or expenditure) then they may assume authority.) |
3 | Content Management | |
3a | Identify the source-of-truth or reference copy for the vocabulary content For the vocabulary managers (steward, custodian) this is the artefact which serves as the source for all other artefacts and representations | Note: Vocabulary users will usually see another specific artefact or access point as the ‘point-of-truth’ i.e. the thing which they must conform to. For example, this could be a web-page, web-service, PDF, book … |
3c | Establish a mechanism for recording details of any changes and revisions
| L Wyborn - We should differentiate between changes in the content, and changes in the technical way the vocabulary is delivered Kheeran D - In 5., it seems very human centric. I think there are two more (related) concerns that should be addressed here: o Does the changes to this vocab need to be machine readable and machine comprehensible? o If so, how is the change communicated in a way to be machine comprehensible? Ben Wu - Changes in locations of content - eg deprecation, superseding etc themselves and change to content (e.g. descriptions) - how are users alerted? |
4 | Revisions and change-requests | |
4a | Determine the revision schedule (e.g., on-demand, yearly, quarterly..) or a trigger mechanism | |
4b | What is the mechanism to request changes
| Kheeran D - As this template is a guide of things that should be considered in vocab governance, I suggest we change the language here to be more enquiring rather than specifying. |
4c | Define the process for evaluation of change requests
| |
5 | Implement and Communicate Changes | |
5a | Implementing changes
| Michael Lawley - Denote and describe versions and releases - A versioning scheme and any rules about compatibility between versions. (e.g., Sem-Ver). This probably overlaps with 5 as well. Michal Lawley - release dependencies - Is this about dependencies on, for example, other vocabularies that might be referenced in properties or maps? KheeranD: Following on from Michael’s comment about dependencies, there needs to be something here to tie it back to what has been identified in 1c. These are instructions for the user of this template, rather than things for consideration by the template user. This differs from the style of the rest of the template. I think they should be reframed as things for consideration by the template user and perhaps as advice as to what they should consider having in place. |
5b | Propagating changes
| Mark Lindsay - what about limited releases prior to a general release - esp. with vocabs with critical dependencies KheeranD - Good point Mark. This also speaks to different levels of maturity. Many vocabs probably won’t have that kind of distinction needed. But some do. Advice, examples should try to cover these different cases to inform the template user. |
5c | Announcing and advertising changes
| |
6 | Persistence and sustainability | |
6a | What is the sustainability plan (i.e., in terms of resources and processes) for the vocabulary? | What gives this the best chance of this vocabulary surviving? Who cares? Links to some things you would think about in a sustainability plan for vocabs of different maturity/for different purposes…. |
6b | Is the content archived? | Archived versions (examples of archival options) - can the content be recovered after the FAIR version dies? Some resources on sustainability plans of some vocab services (e.g. RVA) Separate URIs from URLs
M Wong - can we make clearer/example what is meant by ‘is this content archived’? - referring to machine readable vocabulary (clarify from outset) - is this meaning a static version? MWong - could you separate out ‘is the content archived’ as a separate question, maybe? KheeranD - As part of governance, it is worth explicitly considering the ‘retirement plan’ for a vocab. How can a vocab be gracefully retired from service? This may be due to it being superseded by a different vocab, or it could have outlived its usefulness, or it could be that it is no-longer actively maintained, or ... |
A summary of the analysis using the vocabulary case-studies is attached.
Attachments |
---|
General feedback
The examples to help guide users: being compiled in excel - to demonstrate different levels of ‘robustness’ of governance required and in place
...