Documentation tasks - FAIR - Parent Issue

[ssarrafan]

Add list of tasks to make sure FAIR documentation is updated here

• Update FAIR documentation for renewal #46
  • https://github.com/microbiomedata/docs/blob/main/content/nmdc/src/explanation/fair_data.md
  • https://nmdc-documentation.readthedocs.io/en/latest/explanation/fair_data.html
• https://microbiomedata.org/metadata/
  • Typos in motivation
  • Wordpress
• https://microbiomedata.org/fair/
  • Same text as the readthedocs
  • wordpress will need updated to match the changes in bullet 1
• https://microbiomedata.org/introduction-to-metadata-and-ontologies/
  • Types of metadata figure
  • Wordpress
• https://microbiomedata.org/metadata/overview/
  • "Additional details on processing metadata, coming soon"
  • Add links to GOLD and ENVO
  • Wordpress
• https://microbiomedata.org/data-standards/
  • Update / add to PIDs
  • Wordpress

[ssarrafan]

@mslarae13 did you find any other links or other FAIR related documentation to add to this list? Can we add this task to the next sprint?

[mslarae13]

yeah add it to the sprint. I didn't start this, but I will :)

[mslarae13]

@ssarrafan I think I got them all... I think most of the updates needed here are pretty small. We just need to make sure it's eay to navigate.

[mslarae13]

@eecavanna Think you can help me find the file that makes this page / text

https://microbiomedata.org/metadata/

[mslarae13]

@eecavanna
I also can't find a file for https://microbiomedata.org/introduction-to-metadata-and-ontologies/

[mslarae13]

https://microbiomedata.org/metadata/overview/ is not https://github.com/microbiomedata/docs/blob/main/content/nmdc/src/overview/nmdc_overview.rst

What file builds https://microbiomedata.org/metadata/overview/ ?

[eecavanna]

https://microbiomedata.org/metadata/

https://microbiomedata.org/introduction-to-metadata-and-ontologies/

Hi @mslarae13, both of those web pages are on the WordPress website and not on GitHub. I don't know who manages the website content these days (maybe @jkelliher-github).

[eecavanna]

What file builds https://microbiomedata.org/metadata/overview/ ?

Everything whose URL starts with https://microbiomedata.org/ is on the WordPress website. Do you have a user account for logging into https://microbiomedata.org/wp-admin/?

[mslarae13]

@eecavanna I don't. Are we planning to leave that in wordpress? Or also provide / capture here?

[eecavanna]

I don't know. I'm not familiar with this issue / those pages / that content.