CredentialEngine / Schema-Development

Development of the vocabularies for the CTI models
14 stars 8 forks source link

Classification properties and (subject) resource types (e.g. occupationType, industryType, instructionalProgramType) #799

Closed philbarker closed 1 month ago

philbarker commented 3 years ago

Some classification properties are used with resource types other than the type for which the scheme referenced is as classification. The definition of these properties does not make this usage explicit.

Examples:

For further discussion about this usage see comments at the end of issue #730

The definitions for these properties follows the pattern

Type of industry; select from an existing enumeration of such types such as the SIC, NAICS, and ISIC classifications.

I suggest

Indicates the type of [industry|occupation|instructional program] for which a resource is relevant; select from an existing enumeration of such types such as the ABC DEFG HIJ classifications.

The definition for ceterms:audienceType and ceterms:audienceLevelType, ceterms:assessmentDeliveryType , ceterms:learningDeliveryType already follow roughly similar patterns, e.g. "The type of audience for which the resource is applicable, intended, or useful; select from an existing enumeration of such types."

Other ___Type properties have domains that align with what the relevant classification scheme covers, e.g. learningMethodType has domain LearningOpportunityProfile

siuc-nate commented 3 years ago

Mirroring my post from #730, minus the last line since this is no longer in the context of the october release:

The definition may benefit from some work, but the usage isn't all that different from how we use other properties that point to concepts in a scheme:

In essence, the lack of any actual verb in all of our _____Type properties makes the verb implicit based on the context (ie based on what is doing the pointing) - meaning that this interpretation follows suit with the rest of CTDL:

We use some variation of "type of x; select from an existing enumeration of such types" with a lot of our ____Type properties, so while the definition for instructionalProgramType seems odd in a vacuum, it isn't all that strange when you look at it in the context of the rest of CTDL. That terseness is probably also intentional, since it gives you greater flexibility when interpreting the implicit verb of the property itself. There is some value in that fuzziness.

I guess what I'm saying is: let's not update the definition for instructionalProgramType in a vacuum; let's figure out some logic for doing so that also applies, minimally, to instructionalProgramType, industryType, and occupationType (and ideally to all of our ____Type properties).

philbarker commented 3 years ago

Thanks for copying that over Nate.

I think that my first post for this issue takes into account the points you raise. Unless I missed some, it is only the three ___Type properties that I mention as examples that are used in the way you describe (to point to classification scheme for a different type of resource in order to indicate some relevance) but don't have definitions that make that usage clear. The others either say so in the definition or are only used for types to which the classification applies.

We live with what we have, but going forward we are in a better position to avoid this type of use. For example if we now wanted a property to indicate that something was somehow relevant to some occupation we could point to an object of type ceterms:Occupation -- just as we did with ceasn:substantiatingOccupation.

siuc-nate commented 1 month ago

This one is probably still worth thinking about, but it hasn't come up in a few years, so I'm archiving it for now.