OrganizationRole examples inconsistent with current schema

Open
#2,787 9 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
json
Domain
documentation

Research direction

Start with the linked Schema.org examples Role#eg-0204 and Occupation#eg-0250, then compare the alumniOf and hasOccupation range definitions. Determine the intended relationship between Role, OrganizationRole, Organization, and Occupation, and update the affected schema or examples so the examples conform to the current schema.

Written by the indexing model from the issue text.

Description

no-issue-activity

Two uses of Organization show examples using OrganizationRole in its place, but the schema does not allow for this:

aluminOf

https://schema.org/alumniOf can only be Organization or EducationalOrganization. OrganizationRole is not a subClassOf Organization. Yet Example 2 for role shows AlumniOf using OrganizationRole.

{
    "@context": "https://schema.org",
    "@type": "Person",
    "name": "Delia Derbyshire",
    "sameAs": "http://en.wikipedia.org/wiki/Delia_Derbyshire",
    "alumniOf": {
        "@type": "OrganizationRole",
        "alumniOf": {
            "@type": "CollegeOrUniversity",
            "name": "University of Cambridge",
            "sameAs": "http://en.wikipedia.org/wiki/University_of_Cambridge"
        },
        "startDate": "1959"
    }
}

alumniOf should have Role or OrganizationRole in its range. or perhaps Role/OrganizationRole should have multiple parents?

hasOccupation

Similarly, Example 2 for Occupation shows Role, but hasOccupation has only Occupation in its range.

{
  "@context": "https://schema.org/",
  "@type": "Person",
  "name": "Albert Einstein",
  "hasOccupation": [
    {
      "@type": "Role",
      "hasOccupation": {
      "@type": "Occupation",
      "name": "Patent examiner",
        "occupationalCategory": "23-2099.00"
      },
      "startDate": "1901",
      "endDate": "1906"
    },
    {
      "@type": "Occupation",
      "name": "Professor of Physics",
      "educationRequirements": "PhD in Physics"
    }
  ]
}

Initially filed in google/schema-dts#143

Dominant language
HTML
Stars
6.3k
Forks
962
Avg merge
18h 7m
Merged PRs (30d)
9

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from schemaorg/schemaorg

All issues in schemaorg/schemaorg

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.