Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

448 create book section for implementing care principles for indigenous data #466

Draft
wants to merge 8 commits into
base: 448-create-book-section-for-implementing-care-principles-for-indigenous-data
Choose a base branch
from

Conversation

arojas1
Copy link

@arojas1 arojas1 commented Oct 15, 2024

Updating the ODIS Book.

Drafting:

  • Intro section
  • Project Metadata
  • Label Metadata
  • Notice Metadata
  • Reviewing Label Mapping
  • Reviewing Notice Mapping
  • Reviewing Project Mapping

Internal Review:

  • Local Contexts Team Review
  • ODIS Review

cc: @pbuttigieg @jmckenna
related issues/PR: #398, localcontexts/localcontextshub#198, iodepo/odis-in#23


As Ocean InfoHub is leveraging Schema.org we are using schema.org/CreativeWorks for this type. Any of the properties of Label seen there are valid to use in such a record.

```{literalinclude} ../../../odis-in/dataGraphs/thematics/CreativeWork/graphs/local-contexts-notice.json
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```{literalinclude} ../../../odis-in/dataGraphs/thematics/CreativeWork/graphs/local-contexts-notice.json
```{literalinclude} ../../../odis-in/dataGraphs/thematics/creativeWork/graphs/localContexts-label.json

to match the current structure of the odis-in repo


As Ocean InfoHub is leveraging Schema.org we are using schema.org/CreativeWorks for this type. Any of the properties of Label seen there are valid to use in such a record.

```{literalinclude} ../../../odis-in/dataGraphs/thematics/CreativeWork/graphs/local-contexts-label.json
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```{literalinclude} ../../../odis-in/dataGraphs/thematics/CreativeWork/graphs/local-contexts-label.json
```{literalinclude} ../../../odis-in/dataGraphs/thematics/creativeWork/graphs/localContexts-label.json

to match the current structure of the odis-in repo


As Ocean InfoHub is leveraging Schema.org we are using [schema.org/Project](https://schema.org/Project) for this type. Any of the properties of Project seen there are valid to use in such a record.

```{literalinclude} ../../../odis-in/dataGraphs/thematics/projects/graphs/local-contexts-project-example.json
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```{literalinclude} ../../../odis-in/dataGraphs/thematics/projects/graphs/local-contexts-project-example.json
```{literalinclude} ../../../odis-in/dataGraphs/thematics/projects/graphs/localContexts-project-example.json

to match the current changes in the PR in the odis-in repo

"@vocab": "https://schema.org/"
},
"@type": "Project",
"@id": "https://example.org/id/XYZ",
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
"@id": "https://example.org/id/XYZ",
"@id": "https://example.org/permanentUrlToThisJsonDoc",

all examples in the odis-in repo now use this example url for @id

"@vocab": "https://schema.org/"
},
"@type": "Project",
"@id": "https://example.org/id/XYZ",
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
"@id": "https://example.org/id/XYZ",
"@id": "https://example.org/permanentUrlToThisJsonDoc",

"@vocab": "https://schema.org/"
},
"@type": "Project",
"@id": "https://example.org/id/XYZ",
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
"@id": "https://example.org/id/XYZ",
"@id": "https://example.org/permanentUrlToThisJsonDoc",

@jmckenna
Copy link
Contributor

jmckenna commented Oct 16, 2024

@arojas1 thanks for all of this, it is excellent. A minor/general comment is that I try to limit all text lines (the paragraphs near the top of each of the files in this PR, for example) to around 80 or 90 characters in length - as it makes it easier to read the line when editing, and not have to scroll & scroll to the right to read the many sentences on the one line in your local editing software.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants