docs(terminology): expand into a comprehensive, sourced glossary (206 terms)#1193
Open
lamentierschweinchen wants to merge 1 commit into
Open
Conversation
Replace the ~17-term terminology page with a sourced glossary of 206 terms across blockchain foundations, protocol and architecture, consensus and security, tokens, network/nodes/staking, wallets, ecosystem applications, upgrades, framework and SDK, the agent stack, economics, governance, and day-to-day staking operations. Every entry follows one format: a mechanical definition, a Context line of MultiversX specifics, a See also line of cross-links, and a Source line citing the specific docs page (or repo/post) it is drawn from. The existing staking-operations terms are retained and enriched to the same format. Foundational terms are included on purpose: what is obvious to readers fluent in the docs is not obvious to first-timers. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
radumojic
approved these changes
Jul 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Replaces the current
docs/welcome/terminology.mdpage (about 17 staking-focused terms) with a comprehensive, sourced glossary of 206 terms spanning the whole docs surface: blockchain foundations, protocol and architecture, consensus and security, tokens, network / nodes / staking, wallets and accounts, ecosystem applications, upgrades, framework and SDK, the agent stack, economics, governance, and day-to-day staking operations.The page keeps its
id: terminologyand slug, so the existing sidebar entry (Terminology: ["welcome/terminology"]) resolves unchanged. Only this one file is touched.Format
Every entry follows a single, consistent shape:
The original staking terms (Validate, Stake, Delegate, Stake rewards, Delegate rewards, Unstake, Staking provider, Staking pool, Delegation cap, plus APR/Service Fee/Metachain/Node/Validator/Observer) are retained and brought up to the same enriched format. Foundational terms (block, transaction, account, testnet, faucet, endpoint, gas limit, and so on) are included on purpose: what is obvious to readers fluent in the docs is not obvious to first-timers, and this page is meant to be the thing a newcomer or a search engine lands on for "what is X in MultiversX."
Sourcing
Every entry is grounded in the docs and cites the specific page it came from (for example
docs.multiversx.com/validators/staking-v4,.../tokens/fungible-tokens,.../governance/overview,.../learn/consensus), rather than a single generic link. Where a term is framework behavior or an upgrade/economic decision, it cites the source repository or the governing post. Features in phased rollout (for example Supernova) are labeled as such rather than stated as live.New terms added in this pass, by area:
For docs-team review
This is submitted for your review as the terminology owners. A couple of points I want to flag explicitly rather than paper over:
learn/economics.mdis stale on supply, and I did not want the glossary to contradict it silently. That page still states a fixed maximum theoretical supply of 31,415,926 EGLD and a 10-year inflation schedule. That predates the October 2025 Economic Evolution proposal, which removed the fixed cap and moved EGLD to tail inflation. To avoid asserting the superseded model as current, I did not add a standalone "Inflation (fixed cap)" entry; the current model is carried by the EGLD, Economic Evolution, Tail Inflation, and Staking V5 entries. It would be worth reconcilinglearn/economics.mdwith the Economic Evolution changes in a separate pass.Slashing framing.
validators/overview.mddefines stake slashing (a fine that loses EGLD, for serious offences), whilevalidators/redundancy.mdnotes that slashing for double-signing is a near-future enforcement. The Slashing entry states that nuance rather than implying routine principal slashing; day-to-day unreliability is handled by rating and jailing. Please confirm that framing matches protocol intent.A few forward-looking / lightly-documented terms (Dual Staking on sovereign chains; parts of the agent stack) are labeled as directions or previews, in line with how the docs describe them. Corrections welcome.
Checks
<,{,}occurrences are inside inline code spans; no bare tag-like tokens.codespell docs/welcome/terminology.md --config .codespellpasses clean (the same check as the Spell Check workflow).docs/welcome/terminology.md.