search

CEDStandards / CEDS-Elements

The Common Education Data Standards (CEDS) are an education data management initiative whose purpose is to streamline the understanding of data within and across P-20W institutions and sectors. CEDS includes a common vocabulary complete with standard elements names, definitions, and option sets. This repository contains all the CEDS elements, definitions, option sets and their definitions, and entities and definitions. Its purpose is to expand that vocabulary to meet the needs of every education stakeholder. The expanded vocabulary is then added to the CEDS Integration Data Store and CEDS Data Warehouse – the other two repositories located here.
http://ceds.ed.gov
40 stars 5 forks source link

RDF definitions in term pages #700

Open philbarker opened 1 year ago

philbarker commented 1 year ago

Describe the bug The JSON-LD RDF term definitions in pages such as https://ceds.ed.gov/element/000115

To Reproduce Go to an element page such as https://ceds.ed.gov/element/000115 and view source.

Find the embedded JSON-LD thatdescribes the element, for that page it is

"@context": {
        "rdf:Property": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs:label": "https://www.w3.org/2000/01/rdf-schema#label",
        "rdfs:comment": "https://www.w3.org/2000/01/rdf-schema#comment",
        "rdfs:subPropertyOf": "https://www.w3.org/2000/01/rdf-schema#subPropertyOf",
        "meta:rangeIncludes": "http://meta.schema.org/rangeIncludes",
        "dcterms:hasVersion": "http://purl.org/dc/terms/hasVersion"
    },
    "@id": "https://ceds.ed.gov/element/000115",
    "@type": "Term",
    "rdfs:label": "First Name",
    "rdfs:comment": "The full legal first name given to a person at birth, baptism, or through legal change.",
    "rdfs:label": "Alphanumeric - 75 characters maximum",
    "rdfs:comment": "Workforce Note: To collect data on workforce program participation, a data match will have to be negotiated between state agencies.  The data match makes use of name, social security number, gender and ethnicity data.",
    "rdfs:subPropertyOf": "Adult Education -> AE Staff -> Identity -> Name",
    "rdfs:subPropertyOf": "Adult Education -> AE Student -> Identity -> Name",
    "rdfs:subPropertyOf": "Assessments -> Assessment Result -> Scorer",
    "rdfs:subPropertyOf": "Career and Technical -> CTE Staff -> Identity -> Name",
    "rdfs:subPropertyOf": "Career and Technical -> CTE Student -> Identity -> Name",
    "rdfs:subPropertyOf": "Early Learning -> Early Learning Child -> Identity -> Name",
    "rdfs:subPropertyOf": "Early Learning -> Early Learning Organization -> Contact -> Name",
    "rdfs:subPropertyOf": "Early Learning -> Early Learning Staff -> Identity -> Name",
    "rdfs:subPropertyOf": "Early Learning -> Early Learning Staff -> Professional Development -> Instructor",
    "rdfs:subPropertyOf": "Early Learning -> Parent/Guardian -> Identity -> Name",
    "rdfs:subPropertyOf": "K12 -> K12 Staff -> Identity -> Name",
    "rdfs:subPropertyOf": "K12 -> K12 Staff -> Professional Development -> Instructor",
    "rdfs:subPropertyOf": "K12 -> K12 Student -> Identity -> Name",
    "rdfs:subPropertyOf": "K12 -> Organization -> Contact -> Name",
    "rdfs:subPropertyOf": "K12 -> Parent/Guardian -> Identity -> Name",
    "rdfs:subPropertyOf": "K12 -> SEA -> Contact -> Name",
    "rdfs:subPropertyOf": "Postsecondary -> Organization -> Contact -> Name",
    "rdfs:subPropertyOf": "Postsecondary -> Parent/Guardian -> Identity -> Name",
    "rdfs:subPropertyOf": "Postsecondary -> PS Staff -> Identity -> Name",
    "rdfs:subPropertyOf": "Postsecondary -> PS Student -> Graduate Student -> Thesis/Dissertation Advisor",
    "rdfs:subPropertyOf": "Postsecondary -> PS Student -> Identity -> Name",
    "rdfs:subPropertyOf": "Workforce -> Workforce Program Participant -> Identity -> Name",
    "dcterms:hasVersion": "11"
}

Expected behavior There are a number errors in the usage of the rdf vocabularies.

  1. rdfs:subPropertyOf should be used to refer to the identifier (the value should be a URI) of another RDF property that has a broader scope, so that any value of the property being described would also be a valid value of the property of which it is a sub-property. The values here treat is as meaning the same as "sub element" in an XML sense which is more closely related to the domain of the property.
  2. the second rdfs:label is not a label for the property
  3. the second rdfs:comment is not a definition for the property, which is how this property is normally used.
  4. dcterms:hasVersion should be used to point to another version, i.e. the value should be a URI of another version.

The quickest remedy for these is just to remove the data.