From ea69168f44b1b5a1cfde6e84def408895f6c0b65 Mon Sep 17 00:00:00 2001
From: Fintan Halpenny <fintan.halpenny@gmail.com>
Date: Fri, 15 Mar 2024 10:12:50 +0000
Subject: [PATCH] cli: explain public to private changes

Add an example of changing a public repository to a private
repository, noting that any replicated data will be public, but any
new changes will not be replicated.

Signed-off-by: Fintan Halpenny <fintan.halpenny@gmail.com>
X-Clacks-Overhead: GNU Terry Pratchett
---
 radicle-cli/examples/rad-publish.md | 42 +++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/radicle-cli/examples/rad-publish.md b/radicle-cli/examples/rad-publish.md
index 63a1785e..352ad251 100644
--- a/radicle-cli/examples/rad-publish.md
+++ b/radicle-cli/examples/rad-publish.md
@@ -17,3 +17,45 @@ $ rad publish
 ✗ Error: repository is already public
 ✗ Hint: to announce the repository to the network, run `rad sync --inventory`
 ```
+
+We can also make the repository private again by using `rad id
+update`. However, it's important to note that once the repository is
+published to the network, that set of data will be public until all
+node operators delete it. Any new changes made after making the
+repository private again __will not_ be replicated.
+
+```
+$ rad id update --visibility private --title "Privatise" --description "Reverting the rad publish event"
+✓ Identity revision 774cc1e72641d97d7dc9377745b7f454a9171747 created
+╭───────────────────────────────────────────────────────────────────╮
+│ Title    Privatise                                                │
+│ Revision 774cc1e72641d97d7dc9377745b7f454a9171747                 │
+│ Blob     88f759a4d46e9535766fccec0cbfe1fed6160b1a                 │
+│ Author   did:key:z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi │
+│ State    accepted                                                 │
+│ Quorum   yes                                                      │
+│                                                                   │
+│ Reverting the rad publish event                                   │
+├───────────────────────────────────────────────────────────────────┤
+│ ✓ did:key:z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi  (you) │
+╰───────────────────────────────────────────────────────────────────╯
+
+@@ -1,13 +1,16 @@
+ {
+   "payload": {
+     "xyz.radicle.project": {
+       "defaultBranch": "master",
+       "description": "radicle heartwood protocol & stack",
+       "name": "heartwood"
+     }
+   },
+   "delegates": [
+     "did:key:z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi"
+   ],
+-  "threshold": 1
++  "threshold": 1,
++  "visibility": {
++    "type": "private"
++  }
+ }
+```