docs: add edge infrastructure concept page (Batch 3)#211
Merged
marc0olo merged 5 commits intoMay 8, 2026
Conversation
Member
Author
|
Review notes This PR is clean. All internal links resolve ( Ready to merge. |
Member
Author
|
Two issues to address before merging: Em-dashes (banned project-wide)
Per CLAUDE.md, em-dashes are banned in all prose, including bullet descriptions and "Further reading" / "See also" sections. Missing section anchor
|
Member
Author
|
Feedback addressed:
|
marc0olo
force-pushed
the
infra/learn-hub-migration-prep
branch
from
dabad66 to
d191270
Compare
marc0olo
force-pushed
the
docs/concepts-edge-infrastructure
branch
from
1a86481 to
fd42967
Compare
…gateway, asset certification) Migrates 4 Learn Hub articles from the "ICP and the Internet" section into a single docs/concepts/edge-infrastructure.md page covering API boundary nodes, HTTP gateways, the HTTP Gateway Protocol request lifecycle, and asset certification using chain-key cryptography and certified variables. Adds a "See also" link at the top of docs/references/http-gateway-spec.md.
marc0olo
force-pushed
the
docs/concepts-edge-infrastructure
branch
from
fd42967 to
de6aa62
Compare
…e-verification reference, and sidebar entry Restores the edge infrastructure architecture diagram from Learn Hub. Adds the IC dashboard link for the current API boundary node count. Adds response-verification library to Further reading (missing from original migration). Adds edge-infrastructure to the explicit Concepts sidebar after node-infrastructure. Rebased onto infra/learn-hub-migration-prep.
This was referenced May 9, 2026
marc0olo
added a commit
that referenced
this pull request
May 11, 2026
## Summary - Creates `docs/concepts/edge-infrastructure.md` covering API boundary nodes, HTTP gateways, the HTTP Gateway Protocol request lifecycle, and asset certification (certified variables for query responses) - Adds edge infrastructure architecture diagram from Learn Hub (`edge-infrastructure.png`) - Adds IC dashboard link for current API boundary node count - Adds `edge-infrastructure` to the explicit Concepts sidebar after `node-infrastructure` - Updates `ic-http-gateway` library link to renamed repo (`dfinity/ic-http-gateway-protocol`) - Adds a "See also" link at the top of `docs/references/http-gateway-spec.md` - The HTTPS Outcalls staging file (skipped article) is left untouched ## Staging files deleted - `.migration/learn-hub/how-does-icp-work/icp-and-the-internet/icp-and-the-internet.md` → `docs/concepts/edge-infrastructure.md` (intro section) - `.migration/learn-hub/how-does-icp-work/icp-and-the-internet/icp-edge-infrastructure.md` → `docs/concepts/edge-infrastructure.md` - `.migration/learn-hub/how-does-icp-work/icp-and-the-internet/http-gateway-protocol.md` → `docs/concepts/edge-infrastructure.md#http-gateway-protocol` - `.migration/learn-hub/how-does-icp-work/icp-and-the-internet/asset-certification.md` → `docs/concepts/edge-infrastructure.md#asset-certification` ## Sync recommendation hand-written <!-- Upstream: informed by Learn Hub articles "ICP and the Internet", "ICP Edge Infrastructure", "HTTP Gateway Protocol", "Asset Certification" (migrated, source retired) -->
raymondk
pushed a commit
that referenced
this pull request
May 11, 2026
…ocs (#208) ## Summary Migrates all 57 developer-relevant articles from the Learn Hub \"How does ICP work?\" section into the developer docs, replacing Learn Hub as the canonical source for ICP protocol concepts before the site is retired. This was executed as 9 content batch PRs plus a post-migration review pass, all merged into this staging branch before landing on `main`: **Batch 1 — Protocol stack** (#209): Consensus, peer-to-peer, message routing, execution layer, state synchronization, and performance concept pages under `docs/concepts/protocol/`. **Batch 2 — Node infrastructure** (#210): `docs/concepts/node-infrastructure.md` — TEE (SEV-SNP) attestation, IC-OS layer model (SetupOS / HostOS / GuestOS), TEE key derivation and disk encryption. **Batch 3 — Edge infrastructure** (#211): `docs/concepts/edge-infrastructure.md` — boundary nodes, HTTP gateway, edge caching. **Batch 4 — Evolution and scaling** (#212): `docs/concepts/evolution-scaling.md` — horizontal scaling via subnet sharding, fault tolerance, governance-driven subnet creation, forkless protocol upgrades. **Chain fusion deep dives** (#213): Expanded `docs/concepts/chain-fusion/` with dedicated pages for Bitcoin integration, ckBTC mechanics, Ethereum integration, EVM RPC, Solana RPC, Dogecoin integration, and Exchange Rate Canister. Architecture and flow diagrams migrated to `public/concepts/chain-fusion/`. **Cryptography deep dives** (#214): Expanded `docs/concepts/chain-key-cryptography.md` and `docs/concepts/certified-data.md` with subnet keys, threshold signing internals, and certified communication theory. **Tokens, ledgers, and cycles** (#215): Expanded `docs/concepts/ledgers.md` and `docs/concepts/cycles.md` with ledger architecture, accounts, sub-accounts, cycles ledger transfer semantics, and NNS tokenomics. **Governance deep dives** (#216): Expanded `docs/concepts/governance.md` and added `docs/concepts/sns-framework.md` — NNS neuron attributes and bonuses, voting rewards formula, Neurons Fund, proposal taxonomy, SNS framework and architecture, DAO settings, launch flow, SNS neurons and rewards, and SNS proposals. **Principals and canister model** (#217): Expanded `docs/concepts/principals.md` and `docs/concepts/canisters.md` — principal model, canister control, Wasm execution model, and `docs/concepts/app-architecture.md`. **Post-migration holistic review** (#218, #226): - Navigation restructured across all concepts, guides, and references — sentence case applied throughout, section indices completed - Cross-reference audit: all Learn Hub outbound links replaced with internal doc links; first-use terms linked to their concept pages - Glossary expanded with TEE, boundary node, and cycle-related entries - System canisters content placement corrected - Exchange Rate Canister restructured across concept, reference, and guide pages (#XRC commits) **Migration infrastructure** (initial prep commits): - `.docs-plan/learn-hub-migration.md` — agent workflow and authoring rules for 9-batch execution - `.docs-plan/learn-hub-navigation.md` — per-article mapping (target file, action type, cross-link table) - `AGENTS.md / CLAUDE.md` — Learn Hub removed from external-docs list; linking rule updated - `sidebar.mjs` — all new concept pages registered ## Closes - Closes #187 — Content gap analysis: Learn Hub vs developer docs - Closes #190 — Gap analysis: articles on learn.internetcomptuter.org vs developer-docs `reference` and `concepts` - Closes #226 — Post-migration holistic review (content placement, nav structure, glossary, first-use terms) ## Sync recommendation hand-written (all pages authored from Learn Hub source articles via Zendesk API; no upstream repo to sync from) <!-- Upstream: source articles fetched from learn.internetcomputer.org via Zendesk API (2026-05-06 through 2026-05-11) -->
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
1 participant
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.
Summary
docs/concepts/edge-infrastructure.mdcovering API boundary nodes, HTTP gateways, the HTTP Gateway Protocol request lifecycle, and asset certification (certified variables for query responses)edge-infrastructure.png)edge-infrastructureto the explicit Concepts sidebar afternode-infrastructureic-http-gatewaylibrary link to renamed repo (dfinity/ic-http-gateway-protocol)docs/references/http-gateway-spec.mdStaging files deleted
.migration/learn-hub/how-does-icp-work/icp-and-the-internet/icp-and-the-internet.md→docs/concepts/edge-infrastructure.md(intro section).migration/learn-hub/how-does-icp-work/icp-and-the-internet/icp-edge-infrastructure.md→docs/concepts/edge-infrastructure.md.migration/learn-hub/how-does-icp-work/icp-and-the-internet/http-gateway-protocol.md→docs/concepts/edge-infrastructure.md#http-gateway-protocol.migration/learn-hub/how-does-icp-work/icp-and-the-internet/asset-certification.md→docs/concepts/edge-infrastructure.md#asset-certificationSync recommendation
hand-written