docs: add protocol stack concept pages (Batch 1)#209
docs: add protocol stack concept pages (Batch 1)#209marc0olo wants to merge 2 commits intoinfra/learn-hub-migration-prepfrom
Conversation
…ng, execution, state sync) Migrates 6 Learn Hub articles from the "Blockchain Protocol" section into docs/concepts/protocol/: index, consensus, peer-to-peer, message-routing, execution, and state-synchronization. Updates cross-links in network-overview.md and glossary.md to point to the new internal pages instead of learn.internetcomputer.org.
|
Review notes The structure, content, and internal links all look good. One issue needs to be fixed before merge: Em-dashes (banned per CLAUDE.md): All 6 new files use em-dashes ( No other issues: frontmatter complete on all pages, all internal links resolve, |
Review feedback1. Em-dashes (16 instances across 6 files)Em-dashes are banned project-wide per CLAUDE.md. Replace all
2. Terminology mismatch in
|
All em-dashes in Further reading bullets and numbered list items replaced with colons per project style rules. "The blockchain state" corrected to "The subnet state" in state-synchronization.md for terminology consistency.
|
Feedback addressed:
|
…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
1 participant
Summary
docs/concepts/protocol/subdirectory with 6 new concept pages: protocol stack overview, consensus, peer-to-peer, message routing, execution, and state synchronizationdocs/concepts/network-overview.md: replaces Learn Hub link withconcepts/protocol/index.mddocs/references/glossary.md: replaces 5 Learn Hub links for consensus, peer-to-peer, and message routing entriesStaging files deleted
.migration/learn-hub/how-does-icp-work/blockchain-protocol/blockchain-protocol.md→docs/concepts/protocol/index.md.migration/learn-hub/how-does-icp-work/blockchain-protocol/consensus.md→docs/concepts/protocol/consensus.md.migration/learn-hub/how-does-icp-work/blockchain-protocol/peer-to-peer.md→docs/concepts/protocol/peer-to-peer.md.migration/learn-hub/how-does-icp-work/blockchain-protocol/message-routing.md→docs/concepts/protocol/message-routing.md.migration/learn-hub/how-does-icp-work/blockchain-protocol/execution-layer.md→docs/concepts/protocol/execution.md.migration/learn-hub/how-does-icp-work/blockchain-protocol/state-synchronization.md→docs/concepts/protocol/state-synchronization.mdSync recommendation
hand-written