{"action":"opened","issue":{"url":"https://api.github.com/repos/CredentialEngine/vocabularies/issues/537","repository_url":"https://api.github.com/repos/CredentialEngine/vocabularies","labels_url":"https://api.github.com/repos/CredentialEngine/vocabularies/issues/537/labels{/name}","comments_url":"https://api.github.com/repos/CredentialEngine/vocabularies/issues/537/comments","events_url":"https://api.github.com/repos/CredentialEngine/vocabularies/issues/537/events","html_url":"https://github.com/CredentialEngine/vocabularies/issues/537","id":338753969,"node_id":"MDU6SXNzdWUzMzg3NTM5Njk=","number":537,"title":"History management redux: ","user":{"login":"stuartasutton","id":2939046,"node_id":"MDQ6VXNlcjI5MzkwNDY=","avatar_url":"https://avatars0.githubusercontent.com/u/2939046?v=4","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":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-07-05T23:07:34Z","updated_at":"2018-07-05T23:07:34Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"Nate, we need to return to the terms history and correct a problem. The [meta:ChangeHistory class](http://credreg.net/meta/terms/ChangeHistory) was created to be where the `skos:changeNote` in a terms or concept record pointed and contains a set of [meta:changeSet]() properties pointing to a set of [cs:ChangeSets](http://purl.org/vocab/changeset/schema#ChangeSet) containing changes. While this work predated our understanding of the use of `@list` and `@graph`, section \"1\" of the following image represents how that was intended to work. \r\n\r\n![2018-07-05 use of change history](https://user-images.githubusercontent.com/2939046/42351896-2c1eee54-806c-11e8-870a-f149e7a7e693.png)\r\n\r\n\r\nHere's a snippet of an actual history that follow's this design--contains an instance of  [meta:ChangeHistory class](http://credreg.net/meta/terms/ChangeHistory) and points to one [cs:ChangeSets](http://purl.org/vocab/changeset/schema#ChangeSet):\r\n\r\n```\r\n{\r\n    \"@context\": \"http://credreg.net/ctdl/schema/context/json\",\r\n    \"@id\": \"http://credreg.net/ctdl/termhistory/graph/ActionStatus/json\",\r\n    \"@graph\": [\r\n        { \r\n            \"@type\": \"meta:ChangeHistory\",\r\n            \"@id\": \"http://credreg.net/ctdl/termhistory/ceterms/ActionStatus/json\",\r\n            \"hasChangeSet\": {\r\n                \"@list\": [ \r\n                    {\r\n                         \"@id\": \"http://credreg.net/ctdl/termhistory/ceterms/ActionStatus/json/f8b5b9d3-3932-4371-a30e-d9c47fa40925\" \r\n                    }\r\n                ]\r\n            }\r\n        },\r\n        {            \r\n            \"@id\": \"http://credreg.net/ctdl/termhistory/ceterms/ActionStatus/json/f8b5b9d3-3932-4371-a30e-d9c47fa40925\",\r\n            \"@type\": \"cs:ChangeSet\",\r\n            \"cs:subjectOfChange\": \"ceterms:ActionStatus\",\r\n            \"cs:changeReason\": null,\r\n            \"cs:createdDate\": \"2017-10-18\",\r\n            \"ceterms:subjectWebpage\": [\"https://github.com/CredentialEngine/vocabularies/issues/450\"],\r\n            \"cs:removal\": [\r\n                {\r\n                    \"@type\": \"rdf:Statement\",\r\n                    \"rdf:subject\": \"ceterms:ActionStatus\",\r\n                    \"rdf:predicate\": \"skos:definition\",\r\n                    \"rdf:object\": \"The status of an action.\"\r\n                }\r\n            ],\r\n            \"cs:addition\": [\r\n                {\r\n                    \"@type\": \"rdf:Statement\",\r\n                    \"rdf:subject\": \"ceterms:ActionStatus\",\r\n                    \"rdf:predicate\": \"skos:definition\",\r\n                    \"rdf:object\": \"Types of current status of an action.\"\r\n                }\r\n            ]\r\n        }\r\n    ]\r\n}\r\n```\r\nHowever, what we have implemented is what we see in section 2 of the graphic where the [meta:ChangeHistory class](http://credreg.net/meta/terms/ChangeHistory) is omitted as well as its [meta:hasChangeSet property](http://credreg.net/meta/terms/hasChangeSet). Instead, the term or concept entity points directly to the @graph URI instead of the [meta:ChangeHistory class](http://credreg.net/meta/terms/ChangeHistory). Here's the current json-ld:\r\n\r\n```\r\n{\r\n    \"@context\": \"http://credreg.net/ctdl/schema/context/json\",\r\n    \"@id\": \"http://credreg.net/ctdl/termhistory/ceterms/ActionStatus/json\",\r\n    \"@graph\": [\r\n        {\r\n            \"@id\": \"http://credreg.net/ctdl/termhistory/ceterms/ActionStatus/json/f8b5b9d3-3932-4371-a30e-d9c47fa40925\",\r\n            \"@type\": \"cs:ChangeSet\",\r\n            \"cs:subjectOfChange\": \"ceterms:ActionStatus\",\r\n            \"cs:changeReason\": null,\r\n            \"cs:createdDate\": \"2017-10-18\",\r\n            \"ceterms:subjectWebpage\": [\"https://github.com/CredentialEngine/vocabularies/issues/450\"],\r\n            \"cs:removal\": [\r\n                {\r\n                    \"@type\": \"rdf:Statement\",\r\n                    \"rdf:subject\": \"ceterms:ActionStatus\",\r\n                    \"rdf:predicate\": \"skos:definition\",\r\n                    \"rdf:object\": \"The status of an action.\"\r\n                }\r\n            ],\r\n            \"cs:addition\": [\r\n                {\r\n                    \"@type\": \"rdf:Statement\",\r\n                    \"rdf:subject\": \"ceterms:ActionStatus\",\r\n                    \"rdf:predicate\": \"skos:definition\",\r\n                    \"rdf:object\": \"Types of current status of an action.\"\r\n                }\r\n            ]\r\n        }\r\n    ]\r\n}\r\n```\r\n\r\nIn the code for section 1, I've assigned the `@graph` a URI with a /graph/  path (`http://credreg.net/ctdl/termhistory/graph/ActionStatus/json`) and point instead to the [meta:ChangeHistory class](http://credreg.net/meta/terms/ChangeHistory) inside the `@graph`. I then have the means to use the `hasChangeSet` using `@list` to provide an ordered list of changes.\r\n"}}
{"actor":{"display_login":"stuartasutton"}}