Skip to content

docs: migrate remaining 'staking' terms to 'bonding' #146

Description

@yigitdot

Problem

The staking → bonding terminology migration started in #145 is incomplete. It was originally filed as a glossary-only miss, but an audit (during #187) shows the old staking terminology still survives in one glossary cell and across several other docs + site-copy locations — so the premise that "the rest of the docs were migrated in #145" does not hold.

The economic mechanism is otherwise consistently called bond / bonding / bonded (the contract is CapacityBond; the glossary term is Bond), so these stragglers read as drift.

Rule: migrate technical protocol terms (stake → bond, staked → bonded, staking → bonding). Preserve stake only where it is idiomatic ("having a stake", "skin in the game"), not as a protocol verb/noun.

Remaining occurrences

Glossary — 1 cell left

The other four cells this issue originally listed are already migrated. Only one remains:

Term Current Updated
Client (docs/overview/glossary.mdx:12) "No stake, no gossip publish." "No bond, no gossip publish."

Non-glossary docs + site copy

File:line Current text
docs/protocol/network.mdx:8 "All staked nodes form a flat mesh"
docs/protocol/network.mdx:16 "on-chain staking registry", "every staked node is slashable"
docs/protocol/reputation.mdx:8 "signed gossip reports from staked nodes"
docs/protocol/reputation.mdx:10 "Only staked nodes may submit gossip reports"
docs/protocol/reputation.mdx:20 "re-staking under a new identity"
docs/protocol/takedown.mdx:45 "requires fresh stake under a new identity", "spin up a new operator, restake, re-register"
docs/overview/introduction.mdx:6 "staked independent nodes cache content"
docs/overview/how-it-works.mdx:71 "signed gossip from staked nodes"
docs/docs.json:5 site description — "staked nodes cache and serve content"

Apply the same stake → bond / staked → bonded / staking → bonding substitution (e.g. "bonding registry", "bonded node", "re-bonding", "fresh bond", "re-bond"). None of the above are idiomatic uses.


Originally flagged by @gemini-code-assist[bot] in #145 (comment); re-surfaced on network.mdx:16 and scope-corrected in #187 (comment).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions