How To Manage Code Table Addition or Change Requests (for Code Table Administrators)

Code Tables in Arctos are maintained by the Arctos Community. Arctos Code Table Administrators are community members with code table access who are able to add, edit or delete code table terms. The process for requesting a new code table term or making a change to an existing term is as follows:

Make a Code Table Request

All community members, including Code Table Administrators should submit a GitHub Code Table Request Issue to request any change to any code table.

  1. Complete all pertinent parts of the form.
  2. Tag the issue with an appropriate Priority label.
  3. Add the issue to the Code Table Management Project.
  4. Add the “Needs Discussion” milestone.
  5. If possible, assign the issue to any Arctos community members you know may have an interest in the term.
  6. If there is no response to your request within 2 days, contact one of the Arctos Code Table Administrators for assistance.

Community Discussion

Code Table change requests should be discussed by the community members it may affect. Not all community members monitor GitHub regularly, so it is helpful to assign or mention community members who may have an interest in the topic. For example, a discussion about a change to parts that are used by both mammal and paleo collections should include at least one member from each community. The length of time required for community discussion will vary. Some changes may only take a day and some may linger for months. If the extended discussion of a code table change request you have submitted is hampering your ability to get work done, make sure that the Priority-Critical label is added to the issue.

Issue Summary

Once the community discussion is complete, there should be a “Summary” post to the issue. This post should include:

  1. All details required for a Code Table Administrator to complete the addition, edit or deletion as agreed upon in the community discussion.
  2. Inform the Code Table Managers with @ArctosDB/Code_Table_Administrators
  3. Change the milestone to “Needs Code Table Review”

Code Table Administrator/DBA Evaluation

Two Code Table Administrators and a DBA will evaluate the Summary post. If they agree that the request is straightforward, does not create inconsistencies, and will not significantly impact data already in Arctos, they will demonstrate their agreement by adding a “Thumbs Up” to the Summary post.

Code Table Change Approved by Code Table Administrators and DBA

If two Code Table Administrators and the DBA agree that the request can be implemented, one of the Code Table Administrators will complete the following tasks:

  1. Complete the implementation of the code table change in Arctos.
  2. Remove the priority label.
  3. Remove the milestone
  4. Add the issue to the Arctos Communications Project if the change needs broad communication.
  5. Close the issue.
  6. Move the issue to the “Code Table Edit Complete” column of the Code Table Management Project.

Code Table Change Not Approved by Code Table Administrators and DBA

If a Code Table Administrator or DBA believes further discussion is required, They will take the following steps:

  1. Add the issue to the “Code Table Admins Discussing” column of the Code Table Management Project for discussion at the next monthly Code Table Administrators meeting.
  2. Change the milestone to “Needs Discussion”
  3. If the issue is not already tagged as Priority-Critical or Priority-High, change the priority to Priority-High.
  4. If the issue is already tagged as Priority-Critical, check with the community member who made the original request to determine if there is a need for a special meeting of Code Table Administrators to resolve the issue.
  5. Code Table Administrators Review
  6. If a code table change request is not unanimously approved by two Code Table Administrators and a DBA, the issue will be discussed by The Code Table Administrators at their monthly meeting and either returned to the community for more discussion, conditionally approved, or rejected.

Returned for Discussion

If returned to the community for discussion, it will fall on the original requestor to stimulate discussion and present a new Summary resolution.

Conditional Approval

Occasionally, an issue requires multiple rounds of discussion and a notification to the community prior to implementation as it may affect daily activities of many community members. An example of such an issue can be found in the Nature of ID GitHub discussion. If conditionally approved, it has been deemed that an announcement should be made to the community prior to implementation. In such instances, a member of the Code Table Administrator Team will perform the following:

  1. Add the Blocked: Needs Discussion label to the issue.
  2. Add the Priority-Critical label to the issue.
  3. Change the issue milestone to “Needs Discussion”
  4. Add the issue to the “Critical Issues” column of the AWG Agenda Project.
  5. Facilitate discussion of the request with the Arctos Working Group (AWG) at the next meeting. The AWG will either approve the request, return the request to the community for further discussion, reject the request, or require an announcement of the approval before implementation (see next steps if this is the result).
  6. Prepare an announcement that includes a link to the latest Summary post in the issue and a deadline for community comments that is before the next AWG meeting. Send it to the Arctos Communication Chair for distribution to the Arctos mailing list.
  7. Facilitate discussion of the request with the Arctos Working Group (AWG) at the next meeting. If there are no objections to implementation of the request, the AWG will approve the request. If there are unresolved objections to the request, the AWG will return the request to the community for further discussion.

Rejected

If rejected, a member of the Code Table Administrators will perform the following:

  1. Add the issue to the “Code Table Edit Rejected” column of the Code Table Management Project.
  2. Remove any milestone
  3. Add the Priority-Cancelled label and remove any other Priority labels.
  4. Close the issue.