...
Overview
This proposes a change document structure using Activity Streams. It includes examples for each type of change.
Activity Streams
References:
Specification for Activity Stream 2.0
Sidecar specification describing activity types (e.g. add, delete, etc.)
Add Example:
| Code Block |
|---|
| language | none |
|---|
| title | Add a single triple |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Add term milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> 'milk'@en."
} |
...
| Code Block |
|---|
| language | none |
|---|
| title | Add an entity with a blank node |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Add term milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> b1:.
<b1:> <http://my.authority/vocab/label> 'milk'@en."
} |
Delete Example:
| Code Block |
|---|
| language | none |
|---|
| title | Delete a single triple |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Delete term milk",
"type": "Delete",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> 'milk'@en."
} |
...
| Code Block |
|---|
| language | none |
|---|
| title | Delete a triple with blank node |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Delete term milk",
"type": "Delete",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> b1:.
<b1:> <http://my.authority/vocab/label> 'milk'@en."
} |
Deprecate Example:
| Code Block |
|---|
| title | Deprecate an entity |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Deprecate term milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/cow_milk> <http://my.authority/vocab/status> 'deprecated'.
<http://my_repo/entity/cow_milk> <http://my.authority/vocab/use_instead> <http://my_repo/entity/bovine_milk>."
} |
...
| Code Block |
|---|
| title | Deprecate an entity removing triples that are no longer desired |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Deprecate term milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/cow_milk> <http://my.authority/vocab/status> 'deprecated'.
<http://my_repo/entity/cow_milk> <http://my.authority/vocab/use_instead> <http://my_repo/entity/bovine_milk>."
}
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Delete triples for deprecated cow milk that are no longer valid",
"type": "Delete",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/cow_milk> <http://my.authority/vocab/broader_term> <http://my_repo/entity/milk>.
<http://my_repo/entity/cow_milk> <http://my.authority/vocab/narrow_term> <http://my_repo/entity/bovine_milk>."
} |
Change Example:
| Code Block |
|---|
| language | none |
|---|
| title | Change a single triple |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Delete term milk",
"type": "Delete",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> 'milk'@en."
}
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Add term Milk as a replacement of term milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> 'Milk'@en"
} |
...
| Code Block |
|---|
| language | none |
|---|
| title | Change a triple with blank node intermediary |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Delete term milk",
"type": "Delete",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> b1:.
<b1:> <http://my.authority/vocab/label> 'milk'@en."
}
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Add term Milk as a replacement of term milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/milk> <http://my.authority/vocab/hasLabel> b2:.
<b2:> <http://my.authority/vocab/label> 'milk'@en."
} |
Split Example:
NOTE: For entities, Deprecation is preferred over Delete. As such, the entity being split is shown as deprecated.
...
| Code Block |
|---|
| language | none |
|---|
| title | Split an entity with multiple triples into two entities |
|---|
| collapse | true |
|---|
|
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Deprecate triples related to cow milk.",
"type": "Delete",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/cow_milk> <http://my.authority/vocab/altLabel> 'bovine milk'@en.
<http://my_repo/entity/cow_milk> <http://my.authority/vocab/altLabel> 'oxen milk'@en."
}
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Add term bovine milk split from cow milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/bovine_milk> <http://my.authority/vocab/hasLabel> 'bovine milk'@en.
<http://my_repo/entity/bovine_milk> <http://my.authority/vocab/altLabel> 'cow milk'@en."
}
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Add term oxen milk split from cow milk",
"type": "Add",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/oxen_milk> <http://my.authority/vocab/hasLabel> 'oxen milk'@en.
<http://my_repo/entity/oxen_milk> <http://my.authority/vocab/altLabel> 'cow milk'@en."
}
{
"@context": "https://www.w3.org/ns/activitystreams",
"summary": "Deprecate term cow milk. Split into bovine milk and oxen milk.",
"type": "Deprecated",
"actor": {
"type": "Authority",
"id": "http://my.authority",
"name": "My Authority"
},
"graph": "<http://my_repo/entity/cow_milk> <http://my.authority/vocab/status> 'deprecated'.
<http://my_repo/entity/cow_milk> <http://my.authority/vocab/use_instead> <http://my_repo/entity/bovine_milk>.
<http://my_repo/entity/cow_milk> <http://my.authority/vocab/use_instead> <http://my_repo/entity/oxen_milk>."
}
|
Merge Example:
NOTE: For entities, Deprecation is preferred over Delete. As such, the entities being merged are shown as deprecated.
...