# rad id terminology and concept updates
Radicle uses two important threshold concepts:

1. **Identity Threshold** or **ID Threshold**: The number of delegate signatures required to approve changes to the repository's identity document. This is a system-defined value, calculated as (`votes >= (delegates / 2) + 1`). It cannot be changed by users and ensures a majority consensus for identity updates.

2. **Repository Threshold**: The minimum number of delegate votes required for changes to be accepted as the repository's canonical state. This user-defined value, set in the repository's identity document, determines how many delegates must approve before updates to Git data (like commits, branches, or tags) become the new default state. This value is defined in the repository's identity document and can be adjusted by delegates to suit the project's needs.
(alternate option: **Git Threshold**)

These thresholds operate independently, providing separate controls over a repository's settings and it's data governance.

## Example messaging updates:

radicle/src/cob/patch.rs
> None of the revisions have met the Repository Threshold.

rad-id.1.adoc
> Identity document changes require approval from the system-defined Identity (ID) Threshold of delegates, calculated as (`votes >= (delegates / 2) + 1`). It cannot be changed and ensures a majority consensus for identity updates.

errors (instead of `no quorum was found` )
> Repository threshold not met: Delegate copies of repository data have diverged

rad id show

╭────────────────────────────────────────────────────────────────────────────────────╮
│ Title         Lorem ipsum dolor sit amet                                           │
│ Revision      0f44f78b78098b35c818c3de3f6a691c0d67895e                             │
│ Blob          1215c2a590644a5cf475a930c9544d6bd8b22844                             │
│ Author        alice (did:key:z6MksFqXN3Yhqk8pTJdUGLwATkRfQvwZXPqR2qMEhbS9wzpT)     │
│ State         Pending                                                              │
│                                                                                    │
│ Lorem ipsum dolor sit amet, consectetur adipiscing.                                │
├────────────────────────────────────────────────────────────────────────────────────┤                                                     
| Delegate Votes:                                                                    │
│ ✓ alice (did:key:z6MksFqXN3Yhqk8pTJdUGLwATkRfQvwZXPqR2qMEhbS9wzpT)  Accepted       │
│ ○ bob (did:key:z6MksFqXN3Yhqk8pTJdUGLwATkRfQvwZXPqR2qMEhbS9wzpT)    No Vote        │
|                                                                                    |
│ N more delegate(s) need to accept this proposal for it to pass                     |
╰────────────────────────────────────────────────────────────────────────────────────╯

## Reference materials (current product)


rad-id.1.adoc
28:identity document is versioned and changes to it must be signed by a quorum of delegates.
142:Note that this will require acceptance from a quorum of delegates to take effect.

radicle/src/storage.rs
629: /// Set the repository 'rad/id' to the canonical commit, agreed by quorum.

radicle/src/cob/identity.rs
658:/// Once a revision has reached the quorum threshold of the previous

radicle/src/cob/patch.rs
1040: // None of the revisions met the quorum.
1050: // More than one revision met the quorum.

radicle-cli/examples/rad-id.md
7:For cases where `threshold > 1`, it is necessary to gather a quorum of

radicle-cli/examples/rad-id-collaboration.md
121:the change to meet a quorum of votes (`votes >= (delegates / 2) + 1`):