Closed jeffbaumes closed 2 months ago
@turbomam @naglepuff @marySalvi @jeffbaumes This has come up in some of the data portal user research. What is the best practice for which schema slot should be used for a tool tip display in nmdc UIs like the data portal? The screen shot above indicates it should be slot_usage.$SLOT.annotations.display_hit.value. Is that still correct?
Default to description and have a way of overwriting it. @turbomam will do this for env context terms using annotations (ie brief_description)
See here for existing examples:
[not directly addressing this issue, but noting here as related]
There may be an opportunity to spin out a separate “governance tier” for slot definitions for informal annotations, represented more dynamically e.g. as a database (“slotbase”?) rather than as a set of yaml files in a git repo.
prior art / reference: https://metadata.raid.org/en/latest/#core-extended-and-local-metadata-schema-components
nmdc-server
access the values? Easy with Python SchemaView()Use alt_descriptions
instead?
https://github.com/microbiomedata/berkeley-schema-fy24/pull/167
actually alt_descriptions
isn't the best choice. we do have display_hint
annotations
already. but I propose switching them all to tool_tip
annotations
.
So slot_usage.$SLOT.annotations.tool_tip.value?
@turbomam I don't see any examples in berkeley-schema-fy24 or nmdc-schema which illustrate your most recent suggestion.
Using https://github.com/microbiomedata/nmdc-schema/pull/2120 as an example for how this should be formatted.
Example of preferred way to model this:
annotations:
tooltip:
tag: tooltip
value: GOLD Ecosystem Classification paths describe the surroundings from which an environmental sample or an organism is collected.
annotations:
source: https://gold.jgi.doe.gov/ecosystem_classification
Actually, I don't recommend that format (in which the annotation's key is repeated in the tag
position) unless you need to make additional annotations on the tooltip
annotation.
Otherwise, this compact form is preferable (in my opionion)
annotations:
tooltip: GOLD Ecosystem Classification paths describe the surroundings from which an environmental sample or an organism is collected.
Look into a process and verification that display hints from the schema are being utilized properly by the web UI. Specifically, we could look into doing this for the study metadata in the submission portal and ensure we are directly using display hints like the following in the UI:
@turbomam @cmungall FYI.