add example and tidy up

Ryun1 · Jul 17, 2024 · 46cc4bf · 46cc4bf
1 parent 1e68a8b
commit 46cc4bf
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 15 deletions.
diff --git a/CIP-governance-metadata-cc-rationale/README.md b/CIP-governance-metadata-cc-rationale/README.md
@@ -45,45 +45,40 @@ The following properties extend the potential vocabulary of [CIP-100](https://gi
 - Authors SHOULD use this field to succinctly describe their rationale.
 - Authors SHOULD give a brief overview of the main arguments will support your position.
 - Authors SHOULD use this field to clearly state their stance on the issue.
+- Compulsory
 
 #### `rationale-statement` (outline)
 
 - A long text field.
 - This SHOULD support markdown text styling.
-- Authors SHOULD use this field to succinctly describe their rationale.
-- Authors SHOULD dive into their the main arguments.
+- Authors SHOULD use this field to fully describe their rationale.
+- Authors SHOULD dive into their the main arguments in full detail.
 - Compulsory
 
 #### `relevant-articles`
 
-- A long text field.
+- An array of articles via the references
 - Authors SHOULD use this field to list the relevant constitution articles to their argument.
-- The articles provided may support or 
 - Compulsory
 
-#### `precedents` (discussion)
+#### `precedents`
 
 - A long text field.
-- The author SHOULD use this field to discuss relevant precedent.
+- The author SHOULD use this field to discuss what they feel is relevant precedent.
 - directly passed similar proposals (history of proposals)
-- (consider precedents can discarded when constitutions change)
-- Optional (for abstain)
+- (consider precedents can discarded when constitutions change?)
+- Optional
 
 #### `counterarguments`
 
 - A long text field.
 - The author SHOULD use this field to outline and describe any significant counter arguments to the position taken.
-- Optional (for abstain)
+- Optional
 
 #### `conclusion`
 
 - A long text field.
 - The author SHOULD use this field to conclude their arguments.
-- Compulsory
-
-#### `misc`
-
-- internal disagreement
 - Optional
 
 ### Application

diff --git a/CIP-governance-metadata-cc-rationale/ryans-island-is-unconstitutional.jsonld b/CIP-governance-metadata-cc-rationale/ryans-island-is-unconstitutional.jsonld
@@ -46,10 +46,14 @@
     "summary": "Ryan using treasury funds to buy an island is unconstitutional.",
     "rationale-statement": "The Cardano treasury is not meant to be used for personal gain, it should be for the benefit of the community.",
     "precedents": "No precedent",
-    "relevant-articles": "Article III section 8.",
     "counterarguments": "It would be pretty cool.",
     "conclusion": "In conclusion spending the treasury to benefit a single dude, bad.",
     "references": [
+      {
+        "@type": "Relevant Articles",
+        "label": "Article III section 8.",
+        "uri": "https://github.com/IntersectMBO/interim-constitution/blob/main/cardano-constitution-0.txt#L231"
+      },
       {
         "@type": "Other",
         "label": "A cool island for Ryan",