Skip to content

remove field notes from documentation and add suggester tool text#371

Open
jbasso1 wants to merge 1 commit into
mainfrom
367-remove-field-notes-from-documentation
Open

remove field notes from documentation and add suggester tool text#371
jbasso1 wants to merge 1 commit into
mainfrom
367-remove-field-notes-from-documentation

Conversation

@jbasso1

@jbasso1 jbasso1 commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

On this branch, I removed field notes documentation and added suggester tool text where appropriate.

Details

...

Related issue(s)

#367

Impacted section(s)

@jbasso1 jbasso1 linked an issue Jun 8, 2026 that may be closed by this pull request
@jbasso1 jbasso1 requested review from eecavanna and mslarae13 June 8, 2026 18:08
@jbasso1 jbasso1 marked this pull request as ready for review June 8, 2026 18:08
[![](../_static/images/howto_guides/portal_guide/2025-05_Suggester.png)](../_static/images/howto_guides/portal_guide/2025-05_Suggester.png)

This tool provides suggested metadata based on other information provided. It can be triggered or run automatically and suggestions can be accepted individually or in bulk. This tool currently suggests an elevation value, based on the provided latitude and longitude metadata. This tool will be expanded to other metadata fields and the NMDC welcomes your feedback and suggestions. This can be provided via the [We are here to help](#we-are-here-to-help) tab.
This tool provides suggested metadata based on other information provided. It can be triggered or run automatically and suggestions can be accepted individually or in bulk. This tool currently suggests an elevation value, based on the provided latitude and longitude metadata. When the submission author submits metadata this tool recommmends metadata terms that are potentially relevant to the submission author's submissions and samples, as well as recommended values to complete submission author metadata. This tool is built and uses the submission material provided to make suggestions. The materials include DOIs to publications or data packages, the study description and links. This powerful tool minimizes the mental load on the submission author and still allows for the control of details and content. Once materials are provided and the submission author reviews the AI suggested metadata, the submission author can opt to use the suggested values or dismiss the recommendations. This tool will be expanded to other metadata fields and the NMDC welcomes your feedback and suggestions. This can be provided via the [We are here to help](#we-are-here-to-help) tab.

@eecavanna eecavanna Jun 8, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Added comma after When the submission author submits metadata
  • Fixed typo in recommends
  • Removed is built and
  • Changed materials include to material includes (since previous sentence also uses the singular form, material)
  • Changed DOIs to publications or data packages to DOIs of publications and data packages (to -> of; and or -> and)
Suggested change
This tool provides suggested metadata based on other information provided. It can be triggered or run automatically and suggestions can be accepted individually or in bulk. This tool currently suggests an elevation value, based on the provided latitude and longitude metadata. When the submission author submits metadata this tool recommmends metadata terms that are potentially relevant to the submission author's submissions and samples, as well as recommended values to complete submission author metadata. This tool is built and uses the submission material provided to make suggestions. The materials include DOIs to publications or data packages, the study description and links. This powerful tool minimizes the mental load on the submission author and still allows for the control of details and content. Once materials are provided and the submission author reviews the AI suggested metadata, the submission author can opt to use the suggested values or dismiss the recommendations. This tool will be expanded to other metadata fields and the NMDC welcomes your feedback and suggestions. This can be provided via the [We are here to help](#we-are-here-to-help) tab.
This tool provides suggested metadata based on other information provided. It can be triggered or run automatically and suggestions can be accepted individually or in bulk. This tool currently suggests an elevation value, based on the provided latitude and longitude metadata. When the submission author submits metadata, this tool recommends metadata terms that are potentially relevant to the submission author's submissions and samples, as well as recommended values to complete submission author metadata. This tool uses the submission material provided to make suggestions. The material includes DOIs of publications and data packages, the study description and links. This powerful tool minimizes the mental load on the submission author and still allows for the control of details and content. Once materials are provided and the submission author reviews the AI suggested metadata, the submission author can opt to use the suggested values or dismiss the recommendations. This tool will be expanded to other metadata fields and the NMDC welcomes your feedback and suggestions. This can be provided via the [We are here to help](#we-are-here-to-help) tab.

@eecavanna eecavanna Jun 8, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found this paragraph a little difficult to read. I recommend copy/pasting the text into https://speedreadr.com/readability-checker-results/, clicking "Calculate Readability", clicking on the "Highlighted Text" tab, scrolling down to "Improvement suggestions", and considering those. Here is what they are for this paragraph:

image

@eecavanna

Copy link
Copy Markdown
Collaborator

I approve of this being merged in once this comment thread has been addressed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

remove field notes from documentation

2 participants