diff --git a/Darwin-Core-Maintenance-Frequently-Asked-Questions.md b/Darwin-Core-Maintenance-Frequently-Asked-Questions.md index a1537c3..0e8f2d1 100644 --- a/Darwin-Core-Maintenance-Frequently-Asked-Questions.md +++ b/Darwin-Core-Maintenance-Frequently-Asked-Questions.md @@ -1,35 +1,26 @@ This page is meant to answer questions about the maintenance of the [Darwin Core (DwC) standard](https://www.tdwg.org/standards/dwc/). If you would like to add a question specifically about the maintenance of Darwin Core, [please open an issue](https://github.com/tdwg/dwc/issues/new) explaining what you would like to see covered on this page. If you can not or do not want to use Github, please instead send a message to the mailing list tdwg-content@lists.tdwg.org. -**Who manages the Darwin Core standard?** +## Who manages the Darwin Core standard? The [Darwin Core Maintenance Group](https://www.tdwg.org/community/dwc/) is responsible for the support and evolution of the Darwin Core standard. -**What process does the maintenance of Darwin Core follow?** +## What process does the maintenance of Darwin Core follow? The DwC Maintenance Group adheres to the Biodiversity Information Standards (TDWG) [Vocabulary Maintenance Standard (VMS)](https://www.tdwg.org/standards/vms/) with the processes elaborated in the [Vocabulary Maintenance Specification](https://github.com/tdwg/vocab/blob/master/vms/maintenance-specification.md). -**Can I get involved in maintaining the Darwin Core standard?** +## Can I get involved in maintaining the Darwin Core standard? -Yes! We encourage open participation by anyone with interest in and commitment to making the Darwin Core more useful. +Yes! We encourage open participation by anyone with interest in and commitment to making the Darwin Core more useful. For more information, contact the convener of the [Darwin Core Maintenance Group](https://www.tdwg.org/community/dwc/). -**What can I do for Darwin Core?** +## What can I do for Darwin Core? -Anything that makes the Darwin Core more useful, conducted with respect and understanding. Specifically, you can: -- learn more about Darwin Core and how to use it (be able to recite the [Darwin Core Quick Reference Guide](https://dwc.tdwg.org/terms/) in your sleep; take the [Sporcle Quiz](https://www.sporcle.com/games/gtucobtuco/darwin-core-terms) if you have doubts or need practice; consult the [Darwin Core Questions & Answers site](https://github.com/tdwg/dwc-qa) for additional commentary) -- ask about things you don't know (open an issue in the [Darwin Core Questions & Answers Issue Tracker](https://github.com/tdwg/dwc-qa/issues), or fill in the [Darwin Core Hour Input Form](https://docs.google.com/forms/d/e/1FAIpQLSekd0QSdgiK5ujh6CLZPx9kKTcS-mJRNK_pGWk3b3fHv4x4gQ/viewform?c=0&w=1), or send email to tdwg-content@lists.tdwg.org -- help to point people to the right place to get answers to their questions (you, because you are now an expert, or any of the resources described above) -- share what you know (answer questions on the [Darwin Core Questions & Answers Issue Tracker](https://github.com/tdwg/dwc-qa/issues); create documentation for the [Darwin Core Questions & Answers Wiki](https://github.com/tdwg/dwc-qa/wiki) to explain the details of how best to use Darwin Core; respond to open [Darwin Core Maintenance issues](https://github.com/tdwg/dwc/issues)). +See the [Contributing Guide](https://github.com/tdwg/dwc/blob/master/.github/CONTRIBUTING.md). -**How can I propose a change to the Darwin Core standard?** +## How can I propose a change to the Darwin Core standard? -Changes can be proposed at any time. There are three requirements that must be satisfied in order to justify that a change be considered, the demand requirement, the efficacy requirement, and the stability requirement. Be prepared to satisfy these requirements if you want to make a change. The details of these requirements can be found in Section 3.1 Justifications for Change in the [Vocabulary Maintenance Specification](https://github.com/tdwg/vocab/blob/master/vms/maintenance-specification.md). +See the [Contributing Guide](https://github.com/tdwg/dwc/blob/master/.github/CONTRIBUTING.md). -To initiate the change request, the preferred method is to create a new issue (https://github.com/tdwg/dwc/issues/new/choose) in the Darwin Core Issue Tracker. Use the appropriate template to create a new issue and fill it out as clearly, concisely, and completely as possible. Don't worry, if there are things you can not provide, the Darwin Core Maintenance Group will help you to develop the issue to maturity. If you can not or do not wish to use the Issue Tracker, please send the proposal in a message to tdwg-content@lists.tdwg.org. -- if you want to suggest a change to a Darwin Core term, please use the [Term change template](https://github.com/tdwg/dwc/issues/new?assignees=&labels=Term+-+change&template=term-change-template.md&title=Change+term+-+) -- if you want to suggest a new Darwin Core term, please use the [New term template](https://github.com/tdwg/dwc/issues/new?assignees=&labels=Term+-+add&template=new-term-template.md&title=New+Term+-+) -- for any other request for change to the Darwin Core standard, fill out a new [blank issue](https://github.com/tdwg/dwc/issues/new) - -**When do changes take effect?** +## When do changes take effect? There are two types of changes that can happen in the Darwin Core standard, non-normative and normative. @@ -37,7 +28,7 @@ Non-normative changes are clarifications and error corrections. Usually these ar Normative changes include additions or changes that affect the semantics or use of terms. Normative changes must be introduced as described above under "How can I effect change in DwC?" and must undergo a minimum 30-day public review. A consensus must be achieved during public review in order for a change proposal to move forward to ratification. Normative changes will always result in a new release of the standard. -**How is a public review conducted?** +## How is a public review conducted? Starting in 2021, the goal of the Darwin Core Maintenance Group is to organize a minimum of one comprehensive public review per year of outstanding and mature issues (those that meet all justification requirements have sufficiently clear and complete proposals), resulting in a new release if justified by ratified normative changes. Anyone may participate in the public review. The only requirement is that opinions that are to be taken into account may not be anonymous. @@ -49,11 +40,11 @@ Given the number and diversity of changes that might be proposed, the Darwin Cor No given proposal has to reach a consensus for a release to be made. To avoid a potentially never-ending review the Maintenance Group will assess the state of proposals in the milestone after the first thirty days and decide whether to make a release of those proposals that had no controversy, or to wait long enough to include all of those that appear to have viable solutions to any problems that are identified in public review. -**How can I best contribute to a public review?** +## How can I best contribute to a public review? Constructive comments and questions are welcome. These should be included in the relevant proposal (issue in Github) or through tdwg-content@lists.tdwg.org. Providing assent is considered constructive. The best way to do this, so as not to clutter the conversation, is to use an emoticon reaction to the first comment in the issue. We can use this to gauge the relative level of interest in a proposal. Dissenting opinions must be explained in a comment and must not be anonymous in order to be considered in the revision of the proposal and for the purpose of assessing consensus. -**What happens after the public review?** +## What happens after the public review? The proposals that pass review will be entered into a release candidate, which will be presented to the Biodiversity Information Standards (TDWG) Executive Committee as a comprehensive package. Any proposals not resolved and entered into the release candidate will be left open for further potential development. Proposals will be reviewed at least annually, and those that make no progress toward consensus may be dismissed by the Maintenance Group, though the record of discussions will be kept for future reference.