Vocabulary spec: Add property 'currentVersion'

2 files changed, 38 insertions, 2 deletions

diff --git a/rdf/context.jsonld b/rdf/context.jsonld
index 53559bb..d9972eb 100644
--- a/rdf/context.jsonld
+++ b/rdf/context.jsonld
@@ -21,6 +21,9 @@
             "@id": "forge:previousVersions",
             "@type": "@id",
             "@container": "@list" },
+        "currentVersion": {
+            "@id": "forge:currentVersion",
+            "@type": "@id" },
         "assignedTo": {
             "@id": "forge:assignedTo",
             "@type": "@id" },
diff --git a/spec/vocabulary.md b/spec/vocabulary.md
index 6740e0d..64b95f8 100644
--- a/spec/vocabulary.md
+++ b/spec/vocabulary.md
@@ -310,7 +310,7 @@ reverse chronological order.
 
 **Functional:** Yes
 
-**Inverse of:** (None)
+**Inverse of:** (None, but see [currentVersion](#prop-currentversion))
 
 **Example:**
 
@@ -323,7 +323,7 @@ reverse chronological order.
     "id": "https://dev.example/aviva/notes/107",
     "type": "Note",
     "attributedTo": "https://dev.example/aviva",
-    "content": "I agree!",
+    "content": "I agree!!!!! (edit: fixed a typo)",
     "previousVersions": [
        "https://dev.example/aviva/notes/107_old_version",
        "https://dev.example/aviva/notes/107_very_old_version",
@@ -332,6 +332,39 @@ reverse chronological order.
 }
 ```
 
+## currentVersion {#prop-currentversion}
+
+**URI:** `https://forgefed.peers.community/ns#currentVersion`
+
+**Notes** Specifies the latest. current, up-to-date version of the subject.
+Once the subject specifies the `currentVersion` property, it SHOULD NOT get any
+changes to any other properties. The exception is `currentVersion` itself,
+which MUST be updated whenever needed, to always point to the latest version.
+
+**Domain:** [Object][]
+
+**Range:** [Object][], of the same `@type` as the subject
+
+**Functional:** Yes
+
+**Inverse of:** (None, but see [previousVersions](#prop-previousversions))
+
+**Example:**
+
+```json
+{
+    "@context": [
+        "https://www.w3.org/ns/activitystreams",
+        "https://forgefed.peers.community/ns"
+    ],
+    "id": "https://dev.example/aviva/notes/107_old_version",
+    "type": "Note",
+    "attributedTo": "https://dev.example/aviva",
+    "content": "I agree!!111",
+    "currentVersion": "https://dev.example/aviva/notes/107"
+}
+```
+
 ## assignedTo {#prop-assignedto}
 
 **URI:** `https://forgefed.peers.community/ns#assignedTo`