docs: Batch 8 — tokens, ledgers, and cycles concepts#215
docs: Batch 8 — tokens, ledgers, and cycles concepts#215marc0olo wants to merge 9 commits intoinfra/learn-hub-migration-prepfrom
Conversation
- Add tokenomics.md: ICP token uses, governance rewards, supply dynamics, SNS tokenomics - Add token-ledgers.md: ICP ledger, ICRC ledgers, archives, index canisters, fees - Expand cycles.md: add "How charging works" and "Cycles ledger" sections - Update governance.md: replace Learn Hub link with internal tokenomics.md link - Update concepts/index.md: add tokenomics and token-ledgers entries; fix chain-fusion link - Remove 6 consumed Learn Hub staging files
|
Review notes Two blocking issues and one minor fix needed: 1. Broken links (blocking, dependency on #213): Two links point into
Options: batch-merge after #213, or temporarily link to the flat 2. Em-dash in 3. Minor: No other issues: frontmatter complete on all new pages, |
|
Three issues to address before merging: 1. Em-dash in Em-dashes are banned project-wide (CLAUDE.md). Please replace: with: 2. Broken link in The new section links to
3. Chain-fusion link dependencies in
|
…ers pages - Fix AccountIdentifier em-dash in token-ledgers.md - Revert chain-fusion/ subdirectory links to chain-fusion.md (flat page on main) until PR #213 merges; affects token-ledgers.md and concepts/index.md - Remove broken link to protocol/execution.md#deterministic-time-slicing in cycles.md until PR #209 merges
|
Feedback addressed:
|
…s pages Rename "Token Ledgers" to "Ledgers" and "Token economics" to "Digital asset economics". Replace "token" with "digital asset" throughout prose. Replace "DAO" in governance.md with "community-governed SNS" / "SNS instances". Add ICRC standards links. Fix "on-chain" to "onchain". Remove em-dashes from Upstream comments.
…ain-key term - Rename docs/concepts/token-ledgers.md to docs/concepts/ledgers.md - Update inbound links in concepts/index.md and tokenomics.md - Fix ledgers.md: replace remaining "chain-key digital assets" with "chain-key tokens"
…technical-doc review Keep 'digital asset' only for: first introduction of ICP/SNS governance asset on each page, the 'Digital asset economics' section heading, and table column headers. Change all subsequent references to plain 'asset'.
- Rename tokenomics.md to network-economics.md - Update title to "Network Economics" and description - Rename ## SNS tokenomics section to ## SNS economics - Update inbound links in ledgers.md, governance.md, index.md - Leave 'tokenomics' in governance/launching.md unchanged: domain-appropriate terminology in the SNS launch context (NNS community uses it; dashboard tool is named "SNS Tokenomics Analyzer")
1 participant
Summary
docs/concepts/tokenomics.md— ICP token uses (governance, cycles, node rewards, SNS swaps), voting rewards and maturity mechanism (10%→5% over 8 years), supply dynamics (inflation/deflation), SNS tokenomics configurationdocs/concepts/token-ledgers.md— ICP ledger (AccountIdentifier), ICRC ledgers (principal + subaccount), append-only transaction log, archive canisters, index canisters, fee modelsdocs/concepts/cycles.md— added "How charging works" (memory at intervals, computation per-instruction with DTS, messaging prepayment + refund, special features) and "Cycles ledger" section (canister IDs, ICRC-1/2/3, deposit/withdraw/create_canister, 100M fee per block, replaces cycles wallets)docs/concepts/governance.md— replaced external Learn Hub link with internaltokenomics.mdlinkdocs/concepts/index.md— added tokenomics and token-ledgers entries; fixed chain-fusion link to subdirectory.migration/learn-hub/Sync recommendation
tokenomics.md:informed by learn-hub staging — tokens-governance/tokens-governance.md, tokens-governance/tokenomics.md, sns/tokenomics.mdtoken-ledgers.md:informed by learn-hub staging — tokens-governance/how-token-ledgers-work-on-the-internet-computer.mdcycles.mdadditions:informed by learn-hub staging — canister-smart-contracts/cycles.md, canister-smart-contracts/cycles-ledger.md