New schema field - contact page (#1392)

Motivated by #1383, this PR adds a new schema element for web-based
contact forms. In order to promote transparency, we'll still require a
primary contact person to be set in order to use this field.

- [x] add new schema element
- [x] add example of using schema element (uniprot)
- [x] add component to web UI
- [x] add curation guide
- [x] add unit tests for data integrity

docs/CONTRIBUTING.md

@@ -254,6 +254,14 @@ For the ORCID field, it understood that an ORCID record should correspond to an
 individual in the same spirit as this policy, and that the ORCID service should
 not be abused to represent any non-individual.
 
+In addition to the primary responsible contact person, the Bioregistry has
+structured fields for additional contact methods, such as:
+
+- `contact_page` for annotating the URL of a web page that has contact
+  information, e.g., containing a contact form. Only curate this field if a
+  direct email is not available, as this is the least transparent option for
+  contact
+
 #### Review of New Prefix Requests
 
 Review of new prefix requests is handled by the Bioregistry Review Team, whose

src/bioregistry/app/templates/resource.html

@@ -186,6 +186,10 @@ <h5 style="margin: 0"><a href="{{ url_for("metaregistry_ui.resources") }}">Regis
                             Repository <i class="fab fa-github"></i>
                         </a>
                     {% endif %}
+                    {%- if resource.contact_page %}
+                        <a class="badge badge-pill badge-light" href="{{ resource.contact_page }}">
+                            Contact Page <i class="fas fa-address-book"></i></i></a>
+                    {%- endif %}
                     {% if obo_download %}
                         <a class="badge badge-pill badge-light" href="{{ obo_download }}">
                             OBO <i class="fas fa-download"></i>

src/bioregistry/data/bioregistry.json

@@ -117233,6 +117233,7 @@
       "name": "Rolf Apweiler",
       "orcid": "0000-0001-7078-200X"
     },
+    "contact_page": "https://www.uniprot.org/contact",
     "contributor_extras": [
       {
         "email": "[email protected]",

src/bioregistry/schema/schema.json

@@ -1123,6 +1123,19 @@
           "default": null,
           "description": "The contact email address for the resource. This must correspond to a specific person and not be a listserve nor a shared email account."
         },
+        "contact_page": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "A URL for a web page that has contact information, e.g., containing a contact form. It's required to have a primary contact to have this field, even if the primary contact isn't the preferred mechanism for contact. Only curate this field if a direct email is not available, as this is the least transparent option for contact.",
+          "title": "Contact Page"
+        },
         "owners": {
           "anyOf": [
             {

src/bioregistry/schema/struct.py

@@ -342,6 +342,13 @@ class Resource(BaseModel):
             "person and not be a listserve nor a shared email account."
         ),
     )
+    contact_page: str | None = Field(
+        default=None,
+        description="A URL for a web page that has contact information, e.g., containing a contact form. "
+        "It's required to have a primary contact to have this field, even if the primary contact isn't the "
+        "preferred mechanism for contact. Only curate this field if a direct email is not available, as this "
+        "is the least transparent option for contact.",
+    )
     owners: list[Organization] | None = Field(
         default=None,
         description="The owner of the corresponding identifier space. See also https://github.com/biopragmatics/"

tests/test_data.py

@@ -839,6 +839,25 @@ def test_contacts(self):
                 )
                 self.assert_contact_metadata(resource.contact)
 
+    def test_contact_page(self) -> None:
+        """Test curation of contact page."""
+        for prefix, resource in self.registry.items():
+            if not resource.contact_page:
+                continue
+            with self.subTest(prefix=prefix):
+                self.assertIsNotNone(
+                    resource.get_contact(),
+                    msg="Any Bioregistry entry that curates a contact page also requires a primary "
+                    "contact to promote transparency and openness",
+                )
+                self.assertTrue(
+                    any(
+                        resource.contact_page.startswith(protocol)
+                        for protocol in ("https://", "http://")
+                    ),
+                    msg="Contact page should be a valid URL",
+                )
+
     def test_wikidata_wrong_place(self):
         """Test that wikidata annotations aren't accidentally placed in the wrong place."""
         registry_raw = json.loads(BIOREGISTRY_PATH.read_text(encoding="utf8"))