CINXE.COM
OBO Foundry
<!doctype html> <html lang="en"> <head> <title>OBO Foundry</title><!-- Required meta tags --> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> <!-- Bootstrap CSS --> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.2/dist/css/bootstrap.min.css"> <!-- Prism.js is for code blocks --> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/themes/prism.css" /> <!-- bootstrap icons, see https://icons.getbootstrap.com/#install --> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.9.1/font/bootstrap-icons.css"> <!-- Custom stylesheet --> <link rel="stylesheet" href="/assets/css/style.css"> <link type="application/atom+xml" rel="alternate" href="http://obofoundry.org/feed.xml" title="The OBO Foundry" /> <style> html, body { height: 100%; } body { display: flex; flex-flow: column; } .footer { margin-top: auto; padding-top: 1em; background-color: #f5f5f5; } </style> </head> <body><nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="/"> <img src="/images/foundrylogo.png" alt="" style="max-height: 24px" class="d-inline-block align-text-top"> OBO Foundry </a> <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarSupportedContent"> <ul class="navbar-nav me-auto mb-2 mb-lg-0"> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarAboutDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> About </a> <ul class="dropdown-menu" aria-labelledby="navbarAboutDropdown"> <li><a class="dropdown-item" href="/about-OBO-Foundry.html">About</a></li> <li><a class="dropdown-item" href="/docs/COC.html">Code of Conduct</a></li> <li><a class="dropdown-item" href="/resources">Resources</a></li> <li> <hr class="dropdown-divider"> </li> <li><a class="dropdown-item" href="/docs/OperationsCommittee.html">Operations Committee</a></li> <li><a class="dropdown-item" href="/docs/SOP.html" style="padding-left: 2em">Standard Operating Procedures</a></li> <li><a class="dropdown-item" href="/docs/EditorialWG.html" style="padding-left: 2em">Editorial Working Group</a></li> <li><a class="dropdown-item" href="/docs/TechnicalWG.html" style="padding-left: 2em">Technical Working Group</a></li> <li><a class="dropdown-item" href="/docs/OutreachWG.html" style="padding-left: 2em">Outreach Working Group</a></li> <li><a class="dropdown-item" href="/roles/">OBO Foundry Organizational Roles</a></li> <li> <hr class="dropdown-divider"> </li> <li><a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io">GitHub Project</a></li> <li><a class="dropdown-item" href="https://github.com/OBOFoundry">GitHub Organization</a></li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarPrinciplesDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Principles </a> <ul class="dropdown-menu" aria-labelledby="navbarPrinciplesDropdown"> <li><a class="dropdown-item" href="/principles/fp-000-summary.html">Overview</a></li> <li><a class="dropdown-item" href="/principles/fp-001-open.html">Open (principle 1)</a></li> <li><a class="dropdown-item" href="/principles/fp-002-format.html">Common Format (principle 2)</a></li> <li><a class="dropdown-item" href="/principles/fp-003-uris.html">URI/Identifier Space (principle 3)</a></li> <li><a class="dropdown-item" href="/principles/fp-004-versioning.html">Versioning (principle 4)</a></li> <li><a class="dropdown-item" href="/principles/fp-005-delineated-content.html">Scope (principle 5)</a></li> <li><a class="dropdown-item" href="/principles/fp-006-textual-definitions.html">Textual Definitions (principle 6)</a></li> <li><a class="dropdown-item" href="/principles/fp-007-relations.html">Relations (principle 7)</a></li> <li><a class="dropdown-item" href="/principles/fp-008-documented.html">Documentation (principle 8)</a></li> <li><a class="dropdown-item" href="/principles/fp-009-users.html">Documented Plurality of Users (principle 9)</a></li> <li><a class="dropdown-item" href="/principles/fp-010-collaboration.html">Commitment To Collaboration (principle 10)</a></li> <li><a class="dropdown-item" href="/principles/fp-011-locus-of-authority.html">Locus of Authority (principle 11)</a></li> <li><a class="dropdown-item" href="/principles/fp-012-naming-conventions.html">Naming Conventions (principle 12)</a></li> <li><a class="dropdown-item" href="/principles/fp-013-notification.html">Notification of Changes (principle 13)</a></li> <li><a class="dropdown-item" href="/principles/fp-016-maintenance.html">Maintenance (principle 16)</a></li> <li><a class="dropdown-item" href="/principles/fp-020-responsiveness.html">Responsiveness (principle 20)</a></li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarOntologiesDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Ontologies </a> <ul class="dropdown-menu" aria-labelledby="navbarOntologiesDropdown"> <li><a class="dropdown-item" href="/">Ontology Table</a></li> <li><a class="dropdown-item" href="/id-policy.html">ID Policy</a></li> <li><a class="dropdown-item" href="http://dashboard.obofoundry.org/dashboard/index.html">OBO Dashboard</a></li> <li> <hr class="dropdown-divider"> </li> <li> <a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io/tree/master/ontology"> Ontologies Metadata Source </a> </li> <li> <a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/registry/"> Combined Metadata </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/obo_context.jsonld"> JSON-LD 1.1 Context </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/ontologies.yml"> Ontology YAML </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/ontologies.jsonld"> Ontology JSON-LD </a> </li> <li> <a class="dropdown-item" href="http://purl.obolibrary.org/meta/ontologies.ttl"> Ontology RDF/Turtle </a> </li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarCitationDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Citation </a> <ul class="dropdown-menu" aria-labelledby="navbarCitationDropdown"> <li><a class="dropdown-item" href="/citation/Citation.html">Cite Ontologies</a></li> <li><a class="dropdown-item" href="/citation/RelatedPublications.html">OBO Foundry Publications</a></li> <li><a class="dropdown-item" href="/citation/KnownPublications.html">Known OBO Foundry Ontology Publications</a></li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarParticipateDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Participate </a> <ul class="dropdown-menu" aria-labelledby="navbarParticipateDropdown"> <li> <a class="dropdown-item" href="https://github.com/OBOFoundry/OBOFoundry.github.io/issues">OBO Foundry Issue Tracker</a></li> <li> <a class="dropdown-item" href="https://groups.google.com/forum/#!forum/obo-discuss">OBO-Discuss Mail List</a> </li> <li> <a class="dropdown-item" href="https://groups.google.com/forum/#!members/obo-tools">OBO-Tools Mail List</a> </li> <li> <a class="dropdown-item" href="https://join.slack.com/t/obo-communitygroup/shared_invite/zt-1oq48ttk7-kKo0i6TwntYtAq~Jcjjg4g">OBO Community Slack channel</a> </li> <li> <a class="dropdown-item" href="/docs/NewOBOFC.html">Join the OBO Operations Committee</a> </li> <li> <a class="dropdown-item" href="/faq/how-do-i-register-my-ontology.html">Submit your ontology</a> </li> </ul> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarNewsletterDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> Newsletter </a> <ul class="dropdown-menu" aria-labelledby="navbarNewsletterDropdown"> <li><a class="dropdown-item" href="/newsletter/2024/10/14/6th-issue-newsletter.html">OBO Foundry Newsletter Issue 6</a></li> <li><a class="dropdown-item" href="/newsletter/2024/06/27/5th-issue-newsletter.html">OBO Foundry Newsletter Issue 5</a></li> <li><a class="dropdown-item" href="/newsletter/2024/03/18/4th-issue-newsletter.html">OBO Foundry Newsletter Issue 4</a></li> <li><a class="dropdown-item" href="/newsletter/2023/12/18/3rd-issue-newsletter.html">OBO Foundry Newsletter Issue 3</a></li> <li><a class="dropdown-item" href="/newsletter/2023/09/15/second-issue-newsletter.html">OBO Foundry Newsletter issue 2</a></li> <li><a class="dropdown-item" href="/newsletter/2023/06/16/inaugural-newsletter.html">Inaugural OBO Foundry Newsletter</a></li> </ul> </li> <li class="nav-item"> <a class="nav-link" href="/faq/index.html">FAQ</a> </li> </ul> </div> </div> </nav> <div class="container" style="margin-top: 2em; margin-bottom: 2em;"> <div class="content"> <div> <div class="page-header"> <h1> Principle: Responsiveness (principle 20) </h1> <p></p> </div> </div> <div class="col-md-12"> <div class="row"> <div class="col-md-3"> <ul> <li> <a href="fp-000-summary.html">Overview</a> </li> <li> <a href="fp-001-open.html">Open (principle 1)</a> </li> <li> <a href="fp-002-format.html">Common Format (principle 2)</a> </li> <li> <a href="fp-003-uris.html">URI/Identifier Space (principle 3)</a> </li> <li> <a href="fp-004-versioning.html">Versioning (principle 4)</a> </li> <li> <a href="fp-005-delineated-content.html">Scope (principle 5)</a> </li> <li> <a href="fp-006-textual-definitions.html">Textual Definitions (principle 6)</a> </li> <li> <a href="fp-007-relations.html">Relations (principle 7)</a> </li> <li> <a href="fp-008-documented.html">Documentation (principle 8)</a> </li> <li> <a href="fp-009-users.html">Documented Plurality of Users (principle 9)</a> </li> <li> <a href="fp-010-collaboration.html">Commitment To Collaboration (principle 10)</a> </li> <li> <a href="fp-011-locus-of-authority.html">Locus of Authority (principle 11)</a> </li> <li> <a href="fp-012-naming-conventions.html">Naming Conventions (principle 12)</a> </li> <li> <a href="fp-013-notification.html">Notification of Changes (principle 13)</a> </li> <li> <a href="fp-016-maintenance.html">Maintenance (principle 16)</a> </li> <li> <a href="fp-020-responsiveness.html">Responsiveness (principle 20)</a> </li> </ul> <div class="btn-group" role="group" aria-label="Source"> <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/principles/fp-020-responsiveness.md" > <button type="button" data-toggle="tooltip" title="See FAQ entry: How I do propose edits to principles?" html="true" class="btn btn-outline-primary" > View </button> </a> <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/edit/master/principles/fp-020-responsiveness.md" > <button type="button" data-toggle="tooltip" title="See FAQ entry: How I do propose edits to principles?" html="true" class="btn btn-outline-primary" > Edit </button> </a> <!-- <button type="button" class="btn btn-outline-primary">Help</button> --> </div> <div> This page is generated via <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/blob/master/_layouts/principle.html" >_layouts/principle.html</a >. See <a href="/faq/how-do-i-edit-content.html">edit guide</a> </div> </div> <div class="col-md-9"><p>GO TO: <a href="#recommendations-and-requirements">Recommendations/Requirements</a> | <a href="#implementation">Implementation</a> | <a href="#examples">Examples/Counter‑Examples</a> | <a href="#criteria-for-review">Criteria for Review</a> | <a href="#feedback-and-discussion">Feedback/Discussion</a></p> <h2 id="summary">Summary</h2> <p>Ontology developers MUST offer channels for community participation and SHOULD be responsive to requests.</p> <h2 id="purpose">Purpose</h2> <p>Ontology development benefits from community input, which is strongly encouraged by the OBO Foundry. Accordingly, “responsiveness” is a key quality of our general collaborative spirit. This principle is intended to ensure that channels for community input are available and that responses to input are given swiftly.</p> <h2 id="recommendations-and-requirements">Recommendations and Requirements</h2> <p>Ontology developers MUST set up a public mechanism to track community requests and suggestions (collectively, “issues”), and SHOULD aim to respond within 2-5 working days. To facilitate submission of well-crafted issues, ontology developers SHOULD create a set of guidelines/instructions for contributions. Optional: Establish a discussion forum for more general communication with and between users.</p> <p>Expectations of responsiveness:</p> <ol> <li>Issues are contributions - and should be met by a thankful attitude. When receiving an item on your issue tracker, the first thing to do is thank the contributor, even if it cannot be addressed right away.</li> <li>If an issue cannot be addressed right away, explain when you plan to address the issue.</li> <li>Do not close issues without responding. If an issue is out of scope for a repository, recommend moving it to a different repository.</li> <li>It is recommended that one or more developers be designated to triage issues.</li> </ol> <h2 id="implementation">Implementation</h2> <p><i>Issue tracker:</i> Specify the URL for an issue tracker (GitHub is recommended) in the ontology configuration file (YAML) that is used to display ontology details on the OBO Foundry web site. Specification of the tracker is done using the following text (customized for your ontology) within its <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/tree/master/ontology">metadata file</a>:</p> <p><code class="language-plaintext highlighter-rouge">tracker: <URL pointing to issue tracker></code></p> <p><i>Guideline for contributions (recommended):</i> Create a file called ‘CONTRIBUTING.md’ (<a href="https://github.com/mapping-commons/sssom/blob/master/CONTRIBUTING.md">example</a>) in an easy-to-find main folder for the appropriate ontology (for example, in the root directory of the ontology GitHub repository, where one would expect to find LICENSE or README files). Learn more about contribution guidelines <a href="http://mozillascience.github.io/working-open-workshop/contributing/">here</a>).</p> <p><i>Discussion forum (optional):</i> Establish a discussion forum (For example, Google groups mailing list, Slack, Twitter). Each of these is specified in the configuration file as given below:</p> <p><code class="language-plaintext highlighter-rouge">mailing_list: <email address></code></p> <p><code class="language-plaintext highlighter-rouge">twitter: <twitter handle></code></p> <p><code class="language-plaintext highlighter-rouge">slack: <URL pointing to slack channel></code></p> <h2 id="examples">Examples</h2> <p>Issue tracker: https://github.com/monarch-initiative/mondo/issues</p> <p>Mailing list: mondo-users@googlegroups.com</p> <p>Twitter: diseaseontology</p> <p>Slack: https://geneontologyworkspace.slack.com</p> <h2 id="counter-examples">Counter-Examples</h2> <p>Specifying a private issue tracker. Waiting until an issue is resolved before responding, if such resolution comes well after submission of a ticket.</p> <h2 id="criteria-for-review">Criteria for Review</h2> <p>There is a functioning public issue tracker for ontology requests specified on the OBO Foundry web site.</p> <p><a href="checks/fp_020">This check is automatically validated.</a></p> <h2 id="feedback-and-discussion">Feedback and Discussion</h2> <p>To suggest revisions or begin a discussion pertaining to this principle, please <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/issues/new?labels=attn%3A+Editorial+WG,principles&title=Principle+%2320+%22Responsiveness%22+%3CENTER+ISSUE+TITLE%3E">create an issue on GitHub</a>.</p> <p>To suggest revisions or begin a discussion pertaining to the automated validation of this principle, please <a href="https://github.com/OBOFoundry/OBOFoundry.github.io/issues/new?labels=attn%3A+Technical+WG,automated+validation+of+principles&title=Principle+%2320+%22Responsiveness%22+-+automated+validation+%3CENTER+ISSUE+TITLE%3E">create an issue on GitHub</a>.</p> </div> </div> </div> </div> </div><footer class="footer"> <p class="small text-center text-muted"> © 2024 OBO Technical WG </p> </footer> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.2.2/dist/js/bootstrap.bundle.min.js"></script> <!-- prism.js is for code blocks, see https://prismjs.com --> <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/prism.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/plugins/autoloader/prism-autoloader.min.js"></script> </body> </html>