Radish alpha
r
Radicle website including documentation and guides
Radicle
Git (anonymous pull)
Log in to clone via SSH
guides/user: add section on policies
Fintan Halpenny committed 10 days ago
commit f841506544ded7ce1d084231890d6953ecc83c6a
parent 0fd32c41515c1fbaea69a3bce122c6fda162cefb
1 file changed +37 -0
modified _guides/user.md
@@ -476,6 +476,43 @@ reliable for code collaboration.
> that want to operate public seed nodes: if that's you, check out our
> [Seeder's Guide][seeder] for more details.

+
### Replication Policies
+

+
In the section above, we mentioned a "seeding policy". In this section, we will
+
talk about two kinds of policies: [seeding policies](#seeding-policy) and
+
[follow policies](#follow-policy).
+

+
#### Seeding Policy
+

+
Seeding policy refers to a local configuration per Repository ID (RID) and
+
affects how repositories are replicated.
+

+
A seeding policy can be broken down into two components:
+

+
1. *Policy*: whether the node allows or blocks the repository from being
+
fetched and can either be set to `allow` and `block`. If a seeding policy is
+
set to `block`, then the repository is ignored, rather than fetched.
+
2. *Scope* can be one of two values: `all` or `followed`:
+
   * `all`: the references of *all* peer's namespaces within a repository are fetched.
+
   * `followed` : only the references from your [followed](#follow-policy) peers
+
     are fetched.
+

+
In both cases, the delegates of the repository are also fetched. These peers are
+
privileged since the state of the repository's identity and the default branch
+
are decided by these peers.
+

+
#### Follow Policy
+

+
A follow policy refers to a policy that affects a peer. Similarly to a seeding
+
policy, it can either be `allow` or `block`, but it does not require a scope.
+

+
As mentioned above, this affects the references that are being fetched within a
+
repository. When a seeding policy's scope is `followed`, the set of followed
+
peers, who are `allow` are retrieved.
+

+
Conversely, in all cases above, if a peer's policy is set to `block` their
+
references are never fetched.
+

### Publishing *ch-ch-ch-ch-changes*

<div class="poem"> Still don't know what I was waiting for<br/> Requiring an