NOAA-Omics / noaa-omics-templates

Documentation for study data templates developed by NOAA Omics
https://noaa-omics-templates.readthedocs.io
GNU Affero General Public License v3.0
2 stars 1 forks source link

Update "Note" (Shift-F2) for every field following standard format with external link #23

Open lukenoaa opened 2 months ago

lukenoaa commented 2 months ago

Every field should have a note that gives enough information to fill out that field. Suggested format with example:

Issues:

  1. That PID (http://rs.tdwg.org/dwc/terms/projectContact) is not actually valid, and I can't find a solid reference to projectContact in the DwC docs.
  2. To include all the pertinent information (eg, name, address, organization, email, phone) for multiple contacts, would a JSON format work better and make it easier to get onto GBIF? If yes, how to put JSON content into an Google Sheets cell?
lukenoaa commented 2 months ago

@baydenwillms As we discussed this morning.

baydenwillms commented 2 months ago

@baydenwillms As we discussed this morning.

@lukenoaa The closest matches to 'projectContact' I could find in DarwinCore terms (from a CSV file that also includes deprecated DwC terms) are the following: recordedBy, identifiedBy, georeferencedBy, measurementDeterminedBy, bibliographicCitation, and references. Unfortunately none of them are really for contact info. 'references' is used as a citation to a publication. The other terms are related to the physical collection of the data or for citations.

baydenwillms commented 2 months ago

As for the JSON of contact info, we likely cannot attach it directly to a cell as we can with other types of data (for example, the RGB color value of a cell's fill color is an attribute of the cell itself (attribute name backgroundColor), that can be accessed via Gspread):

        # Determine the background color based on the presence of '*'
        if actual_term.startswith('*'):
            bgcolor = Color(0.0, 1.0, 0.0)  # Google sheets Green
        else:
            bgcolor = Color(1.0, 1.0, 0.0)  # Google Sheets yellow

        format_requests.append((**cell, **CellFormat(backgroundColor=bgcolor**)))

but we could easily 'stringify' the JSON to a single line which can be parsed easily, and add that as a comment/note to the cell or as the data value of a cell.

lukenoaa commented 2 months ago

The project contact information will be covered by Miwa's new checklist terms (should be DwC-compatible):

lukenoaa commented 2 months ago

New issue: