Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: remove not-applicable confusing terms #618

Merged
merged 1 commit into from
Nov 29, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 1 addition & 38 deletions docs/src/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@ This document provides definitions and explanations for terms used throughout th
## Table of Contents

- [Glossary and Anti-Glossary](#glossary-and-anti-glossary)
- [Table of Contents](#table-of-contents)
- [Glossary](#glossary)
- [Actor](#actor)
- [Bond](#bond)
Expand All @@ -30,15 +29,11 @@ This document provides definitions and explanations for terms used throughout th
- [Relay Chain](#relay-chain)
- [Sector](#sector)
- [Session](#session)
- [Slashing](#slashing)
- [Slot Auction](#slot-auction)
- [Staking](#staking)
- [Storage Provider](#storage-provider)
- [Storage User](#storage-user)
- [System Parachain](#system-parachain)
- [Anti-Glossary](#anti-glossary)
- [Term to Avoid: Miner](#term-to-avoid-miner)
- [Term to Avoid: Pledge](#term-to-avoid-pledge)

## Glossary

Expand Down Expand Up @@ -234,31 +229,7 @@ The process of penalizing network participants, including [validators](#validato
and [collators](#collator), for various protocol violations. These violations could include producing invalid blocks,
equivocation (double signing), inability of the [Storage Provider](#storage-provider) to [prove](#proofs) that the data
is stored and maintained as promised, or other malicious activities. As a result of slashing, participants may face a
reduction in their [staked](#staking) funds or other penalties depending on the severity of the violation.

### Slot Auction

To secure a [parachain](#parachain) slot, a project must win an auction by [pledging](#term-to-avoid-pledge) (locking
up) a significant amount of DOT tokens. These tokens are used as [collateral](#collateral) to secure the slot for a
specified period. Once the slot is secured, the project can launch and operate its [parachain](#parachain).

### Staking

Staking is when DOT holders lock up their tokens to support the network's security and operations. In
return, they can earn rewards. There are two main roles involved in staking:

- <a name="validators"></a>**Validators**:
Validators produce new blocks, validate transactions, and secure the network.
They are selected based on their stake and performance.
Validators must run a [node](#node) and have the technical capability to maintain it.

- <a name="nominators"></a>**Nominators**: Nominators support the network by backing (nominating) validators they trust
with their DOT tokens. Nominators share in the rewards earned by the validators they support. This allows DOT holders
who don't want to run a validator node to still participate in the network's security and earn rewards.

Our parachain will use staking to back up the [collators](#collator) similarly to "Nominators".
In this regard, "Nominators" will fall to [Storage Providers](#storage-provider),
while " Validators" will be assigned to [Collators](#collator) accordingly.
reduction in their staked funds or other penalties depending on the severity of the violation.

### Storage Provider

Expand Down Expand Up @@ -294,13 +265,5 @@ However, this term cannot be used in the [Polkadot](#polkadot) ecosystem because
the [Relay Chain](#relay-chain) is responsible for block production. [Parachains](#parachain) can only prepare block
candidates via the [Collator](#collator) node and pass them to the [Relay Chain](#relay-chain).

### Term to Avoid: Pledge

It's better to apply this term within its proper context rather than avoiding it altogether. It's easy to confuse it
with [staking](#staking), but they have distinct meanings.

**Reason**: Pledging generally refers to locking up tokens as [collateral](#collateral) to participate in certain
network activities or services like: [Parachain Slot Auctions](#slot-auction) and [Crowdloans](#crowdloan).

[1]: https://wiki.polkadot.network/docs/learn-DOT#the-planck-unit
[2]: https://wiki.polkadot.network/docs/learn-transactions#pallets-and-extrinsics