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

Create a new page to explain schema groups #48

Open
rmseifried opened this issue Feb 27, 2023 · 3 comments
Open

Create a new page to explain schema groups #48

rmseifried opened this issue Feb 27, 2023 · 3 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@rmseifried
Copy link
Member

rmseifried commented Feb 27, 2023

Issue

There is some confusion about how individual fields in the schema groups relate to each other.

For example, we agreed in #30 that we want a new page that discusses the differences between these "Spatial" fields:

Spatial Coverage (S)
Geometry (S)
Bounding Box (S)
Centroid

And we agreed in #21 to link "Relations" to the overview at New elements for item relations and see if that section needs enhancements.

Suggested fix

  1. Create a new page (under Resources for now) that explains our rationale for each of the groups and how the fields relate to each other.
  2. Link each section to the schema group headings on the schema page
@rmseifried rmseifried added the documentation Improvements or additions to documentation label Feb 27, 2023
@kgjenkins
Copy link
Collaborator

kgjenkins commented Mar 1, 2023

Here's the pages we definitely want to have a group page for:

  • Categories (Marc)
  • Temporal (Becky)
  • Spatial (Keith)
  • Relations
  • Rights

Marc and Keith propose having separate pages for each, in the ogm-aardvark, named like group-categories.md

@kgjenkins
Copy link
Collaborator

kgjenkins commented Mar 1, 2023

I created a schema-groups branch, which has a new file group-spatial.md -- feel free to edit that branch directly if you like.

Also, we'll probably want to have a relatively consistent structure to these pages, but for now it might be good to have a variety of styles, and see what works best.

@rmseifried
Copy link
Member Author

rmseifried commented Mar 2, 2023

I added a new file group-temporal.md directly to the schema-groups branch.

I deliberately structured it differently (per @kgjenkins recommendation) to give us some style flavor to choose from!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
Status: In Progress
Development

No branches or pull requests

3 participants