{"action":"created","issue":{"url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/issues/234","repository_url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies","labels_url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/issues/234/labels{/name}","comments_url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/issues/234/comments","events_url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/issues/234/events","html_url":"https://github.com/CredentialTransparencyInitiative/vocabularies/issues/234","id":191297891,"number":234,"title":"Referencing the JSON context file (and other schema files)","user":{"login":"stuartasutton","id":2939046,"avatar_url":"https://avatars.githubusercontent.com/u/2939046?v=3","gravatar_id":"","url":"https://api.github.com/users/stuartasutton","html_url":"https://github.com/stuartasutton","followers_url":"https://api.github.com/users/stuartasutton/followers","following_url":"https://api.github.com/users/stuartasutton/following{/other_user}","gists_url":"https://api.github.com/users/stuartasutton/gists{/gist_id}","starred_url":"https://api.github.com/users/stuartasutton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stuartasutton/subscriptions","organizations_url":"https://api.github.com/users/stuartasutton/orgs","repos_url":"https://api.github.com/users/stuartasutton/repos","events_url":"https://api.github.com/users/stuartasutton/events{/privacy}","received_events_url":"https://api.github.com/users/stuartasutton/received_events","type":"User","site_admin":false},"labels":[{"id":487429956,"url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/labels/Context%20(JSON)","name":"Context (JSON)","color":"b60205","default":false},{"id":480262487,"url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/labels/PURLS","name":"PURLS","color":"0e8a16","default":false},{"id":477570554,"url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/labels/Serializations","name":"Serializations","color":"fbca04","default":false}],"state":"open","locked":false,"assignee":{"login":"siuc-nate","id":21346519,"avatar_url":"https://avatars.githubusercontent.com/u/21346519?v=3","gravatar_id":"","url":"https://api.github.com/users/siuc-nate","html_url":"https://github.com/siuc-nate","followers_url":"https://api.github.com/users/siuc-nate/followers","following_url":"https://api.github.com/users/siuc-nate/following{/other_user}","gists_url":"https://api.github.com/users/siuc-nate/gists{/gist_id}","starred_url":"https://api.github.com/users/siuc-nate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/siuc-nate/subscriptions","organizations_url":"https://api.github.com/users/siuc-nate/orgs","repos_url":"https://api.github.com/users/siuc-nate/repos","events_url":"https://api.github.com/users/siuc-nate/events{/privacy}","received_events_url":"https://api.github.com/users/siuc-nate/received_events","type":"User","site_admin":false},"assignees":[{"login":"siuc-nate","id":21346519,"avatar_url":"https://avatars.githubusercontent.com/u/21346519?v=3","gravatar_id":"","url":"https://api.github.com/users/siuc-nate","html_url":"https://github.com/siuc-nate","followers_url":"https://api.github.com/users/siuc-nate/followers","following_url":"https://api.github.com/users/siuc-nate/following{/other_user}","gists_url":"https://api.github.com/users/siuc-nate/gists{/gist_id}","starred_url":"https://api.github.com/users/siuc-nate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/siuc-nate/subscriptions","organizations_url":"https://api.github.com/users/siuc-nate/orgs","repos_url":"https://api.github.com/users/siuc-nate/repos","events_url":"https://api.github.com/users/siuc-nate/events{/privacy}","received_events_url":"https://api.github.com/users/siuc-nate/received_events","type":"User","site_admin":false}],"milestone":{"url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/milestones/4","html_url":"https://github.com/CredentialTransparencyInitiative/vocabularies/milestones/Immediate%20Updates","labels_url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/milestones/4/labels","id":2149914,"number":4,"title":"Immediate Updates","description":"A pre-holiday update to CTDL","creator":{"login":"siuc-nate","id":21346519,"avatar_url":"https://avatars.githubusercontent.com/u/21346519?v=3","gravatar_id":"","url":"https://api.github.com/users/siuc-nate","html_url":"https://github.com/siuc-nate","followers_url":"https://api.github.com/users/siuc-nate/followers","following_url":"https://api.github.com/users/siuc-nate/following{/other_user}","gists_url":"https://api.github.com/users/siuc-nate/gists{/gist_id}","starred_url":"https://api.github.com/users/siuc-nate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/siuc-nate/subscriptions","organizations_url":"https://api.github.com/users/siuc-nate/orgs","repos_url":"https://api.github.com/users/siuc-nate/repos","events_url":"https://api.github.com/users/siuc-nate/events{/privacy}","received_events_url":"https://api.github.com/users/siuc-nate/received_events","type":"User","site_admin":false},"open_issues":10,"closed_issues":19,"state":"open","created_at":"2016-11-21T20:59:16Z","updated_at":"2016-11-29T22:02:58Z","due_on":"2016-12-05T00:00:00Z","closed_at":null},"comments":1,"created_at":"2016-11-23T15:09:32Z","updated_at":"2016-11-30T15:27:10Z","closed_at":null,"body":"Email from Eric Korb to me:\r\n\r\n> \"Two main questions: 1. Is this the endpoint for the vocabs? http://purl.org/ctdl/terms/; and 2. What is the endpoint for the context?\"\r\n\r\n> **NOTE:** Eric's email throws light on the potential confusion between purls that resolve to human-readable HTML pages **about** the CTDL /terms/ and /vocabs/ and purls that resolve to serializations of /terms/ and /vocabs/. In a separate issue #233, I'll propose a solution... \r\n\r\nEric's very legitimate questions regard the **direct** endpoint of serializations--(1) for the /terms/ (properties/classes/concept scheme classes) and /vocabs/ (concept classes); and, (2) for the JSON context file. \r\n\r\n### Context file access\r\n(http://credreg.net/ctdl/Schema?type=json&direct=true)\r\n\r\nSchema.org has two ways to two access mechanisms to its context file: (1) browser 'content negotiation'; and (2) direct link (see, [schema.org issue 990](https://github.com/schemaorg/schemaorg/issues/990). This is what Eric is asking for in terms of context file access. It might well be worth creating a purl that resolves to the context file; perhaps:\r\n\r\n> http://purl.org/ctdl/jsonldcontext/ (302) that resolves to the jsonldcontext.json file directly or via http://credreg.net/ctdl/Schema?type=json&direct=true. \r\n\r\n### CTDL /terms/ schema file and vocabs files (.ttl, json-ld) \r\n(http://credreg.net/ctdl/Schema?type=turtle&direct=true, http://credreg.net/ctdl/Schema?type=schema&direct=true)\r\n\r\nWe are incomplete here in terms of having complete turtle and json-ld serialization files for both the schema in /terms/ and the schemes in /vocabs/. When they are complete, we should be able to directly access indepentent file pairs (.ttl & .jsonld)  for the /terms/ and each set of the vocabulary concepts in /vocabs/. "},"comment":{"url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/issues/comments/263901889","html_url":"https://github.com/CredentialTransparencyInitiative/vocabularies/issues/234#issuecomment-263901889","issue_url":"https://api.github.com/repos/CredentialTransparencyInitiative/vocabularies/issues/234","id":263901889,"user":{"login":"siuc-nate","id":21346519,"avatar_url":"https://avatars.githubusercontent.com/u/21346519?v=3","gravatar_id":"","url":"https://api.github.com/users/siuc-nate","html_url":"https://github.com/siuc-nate","followers_url":"https://api.github.com/users/siuc-nate/followers","following_url":"https://api.github.com/users/siuc-nate/following{/other_user}","gists_url":"https://api.github.com/users/siuc-nate/gists{/gist_id}","starred_url":"https://api.github.com/users/siuc-nate/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/siuc-nate/subscriptions","organizations_url":"https://api.github.com/users/siuc-nate/orgs","repos_url":"https://api.github.com/users/siuc-nate/repos","events_url":"https://api.github.com/users/siuc-nate/events{/privacy}","received_events_url":"https://api.github.com/users/siuc-nate/received_events","type":"User","site_admin":false},"created_at":"2016-11-30T15:27:10Z","updated_at":"2016-11-30T15:27:10Z","body":"While working on this yesterday, I came up with a couple of potential setups for the URL structure - I would like to keep a consistent structure and ordering of parameters that is as PURL-friendly as possible.  To that end, I settled on these two possibilities:\r\n![image](https://cloud.githubusercontent.com/assets/21346519/20758156/93dc71f0-b6de-11e6-8ba3-96bb656bb5b4.png)\r\n\r\nThe first set, highlighted in green, is what I am strongly leaning towards.  Most notably, it enables PURL-izing the schema serializations - it also means that targeting a specific release (which will likely be a rare task) is consistently the last (and consistently optional) parameter. \r\n\r\nSomething else to consider would be not using a URL structure to handle the format _or_ the release - these can be handled via URL parameters (e.g., /ctdl/terms/costType?format=json&release=20161117 ).  Parameters like this function independent of each other and/or the order they're included in - the only downside is that their URLs are not as \"clean\" looking.\r\n"}}
{"actor":{"display_login":"siuc-nate"}}