CredentialEngine / CredentialRegistry

Repository for development of the Credential Registry
Apache License 2.0
12 stars 10 forks source link

Add Simple and Robust Language Map Examples to the Registry Repo #548

Open jeannekitchens opened 2 years ago

jeannekitchens commented 2 years ago

Let's add simple and robust raw data examples to the Registry repo to use as an example in the sandbox and as a go-to for explanation an showing partners how language maps works. Use a real credential org, credential, and competency framework. Use English and another language such as Arabic. Would there be a benefit to the example using three languages or is it really more of the same?

Complex example: Use the Education Design Labs https://credentialengineregistry.org/graph/ce-5ea303a9-0cba-42db-b828-38d2f1fb890d Use one EDL credential https://credentialengineregistry.org/graph/ce-b8052f45-8174-47d4-86a6-e83e963bed7e Use one EDL competency framework https://credentialengineregistry.org/graph/ce-e49dcaf3-5885-46e8-bd3c-cdbe765a8f1b

Simple example is shown below: { "@id": "https://credentialengineregistry.org/resources/ce-53bc7e5d-d39c-4687-ac89-0474f691055d", "@type": "ceterms:MasterDegree", "ceterms:ctid": "ce-53bc7e5d-d39c-4687-ac89-0474f691055d", "ceterms:name": { "en": "Master of Business Administration (MBA)", "ar": "ماجستير في إدارة الأعمال" }, "ceterms:ownedBy": [ "https://credentialengineregistry.org/graph/ce-8DDBF031-BAD6-4B19-B726-066D5F71AD01" ] }

mparsons-ce commented 2 years ago

Sample in sandbox: https://sandbox.credentialengineregistry.org/graph/ce-cef8a76d-f168-0513-8fac-0b8dc60ef853

stuartasutton commented 2 years ago

I find the data potentially confusing in some places, particularly where there are arrays with comma separated word/phrases in one language and another of the matching word/phrases in another language like this:

ceterms:keyword: { ar-sa: [ "Blah in ar-sa", "Blah2 in ar-sa", "Blah3 in ar-sa" ], en-us [ "Blah in en-us", "Blah2 in en-us", "Blah3 in en-us" ] }

when it should be:

ceterms:keyword: {``` [ "Blah in en-us", "Blah in ar-sa ], [ "Blah2 in en-us", "Blah2 in ar-sa", ], [ "Blah3 in en-us", "Blah3 in ar-sa", ], }

siuc-nate commented 2 years ago

That was my thought too, back when we first started researching how language maps work. But the specification defines it how you have it in your first example. I can't remember now where I read it, but I vaguely recall reading something that indicated that the potential for having a different number of items in each language's array was intentional, as that may reflect the correct usage of that language (e.g., a given keyword may exist in one language but not the other).

stuartasutton commented 2 years ago

While I'd have to dig, Phil might be able to provide examples from multi-lingual EU and United nations contexts. The issue is one of unambiguous clarity and not of any formal JSON-LD constraint.

siuc-nate commented 2 years ago

I'm not quite sure what you mean - are you suggesting violating the JSON-LD spec?