Science On Schema.Org (SOSO) Guidance Documents

This repository provides guidance for repository operators and others to follow consistent conventions to provide schema.org markup in Dataset landing pages to improve data discovery through search engines. The main guides help describe Datasets and Data Repositories.

Name		Guideline	Examples	Issues
Dataset	guidelines for schema.org for a scientific Dataset
Data Repository	guidelines for schema.org for a research data repository

• Getting Started - explains some useful techniques that will be common across all schema.org types
• Experimental - some suggestions for more advanced dataset documentation, proposed for inclusion in future SOSO guidelines.

Citation

Science on Schema.org (SOSO) releases are archived on Zenodo, and the current release should be cited as:

Adam Shepherd, Matthew B. Jones, Stephen Richard, Nicholas Jarboe, Dave Vieglais, Douglas Fils, Ruth Duerr, Chantelle Verhey, Melinda Minch, Bryce Mecum, Nokome Bentley. (2023). Science-on-Schema.org v1.3.2. Zenodo. https://doi.org/10.5281/zenodo.7884538

Community

This guidance has been created by members of the ESIP science-on-schema.org cluster. The cluster will be seeking endorsement across all members of ESIP, and in the meantime is releasing a series of progressively more mature guidance documents for the community. Your feedback and contributions are welcome. The cluster meets twice monthly, and all are welcome:

• When:
  • 4th Thursday, 2:30pm ET
• Where: Telecons via Zoom
  • Connection: https://us02web.zoom.us/j/84043422486?pwd=bGM4YkFyMkFGSW1FZG5yaFRNaGNvdz09
  • Phone Access: United States: +1 (786) 535-3211
  • Dial by your location (Find your local number: https://us02web.zoom.us/u/kcKljXMoF0)
• Living Agenda

Version DOIs

Version	DOI
1.3.2
1.3.1
1.3.0
1.2.0
1.1.0
1.0.0

Contributors

Adam Shepherd 🎨 💻 🖋 📖 📋 🤔 🚧	Matt Jones 🎨 💻 🖋 📖 📋 🤔 🚧	Stephen Richard 🎨 💻 🖋 📖 📋 🤔 🚧	njarboe 🎨 💻 🖋 📖 📋 🤔 🚧
Dave Vieglais 🎨 💻 🖋 📖 📋 🤔 🚧	Douglas Fils 🎨 💻 🖋 📖 📋 🤔 🚧	rduerr 🎨 💻 🖋 📖 📋 🤔 🚧	Chantelle Verhey 🖋 📖 🤔
Melinda Minch 🖋 📖	Bryce Mecum 💻 🖋 📖	Nokome Bentley 🖋 📖	Lewis John McGibbney 🖋 📖
Charles Vardeman 🖋 📖	Simon Cox 🖋 📖	Dan Brickley 🖋 📖	HPeat 🖋 📖
John Graybeal 🖋 📖	ChantelRidsdale 🖋 📖 🤔	mcorlando 🖋 📋	Josef Hardi 🤔
Øystein Godøy 🤔	Richard Wallis 🤔	Siri Jodha S Khalsa 🤔	Mathias Bockwoldt 🤔

Resources

• ESIP and this group
  • Learn about ESIP
  • Join ESIP Slack for real time chat
  • Chat on the sci-schemaorg Slack channel
  • sci-schemaorg mailing list
  • sci-schemaorg wiki
• History
  • This guide is a continuation of the P418 NSF EarthCube vocabulary guidance which ended in April 2018.
• Broader Community
  • Schema.org development
  • Schema.org archived history, can be helpful when determining intent
  • Data Catalog Vocabulary (DCAT)
  • Bioschemas
  • Geoschemas
  • Shape Constraint Language (SHACL)
  • Comparison of SHACL tool implementations
• Tools
  • Gleaner EarthCube developed tools for working with structure data
  • exstruct python tool for extracting microdata
  • Schema.org Validator
  • Google Rich Results Tool
  • Google dataset search
  • TopQuadrant TopBraid SHACL validator
  • pySHACL
  • SHACL playground

License

Copyright [2022] [Adam Shepherd, Matthew B. Jones, Stephen Richard, Nicholas Jarboe, Dave Vieglais, Douglas Fils, Ruth Duerr, Chantelle Verhey, Melinda Minch, Bryce Mecum, Nokome Bentley]

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.