diff --git a/.docs-plan/synthesis.md b/.docs-plan/synthesis.md index 10c18ab9..a5472194 100644 --- a/.docs-plan/synthesis.md +++ b/.docs-plan/synthesis.md @@ -113,7 +113,7 @@ | # | Path | Title | doc_type | level | Content Brief | Source Material | Cross-Links | Priority | |---|------|-------|----------|-------|---------------|-----------------|-------------|----------| -| 40 | `guides/governance/launching.md` | Launching an SNS | how-to | advanced | Decentralize your dapp with an SNS. Token economics configuration, governance parameters, integration checklist, NNS proposal submission. | Portal building-apps/governing-apps/launching/ (4 files), tokenomics/ (4 files); icskills: sns-launch; examples: sns-adaptor (Rust) | concepts/governance, guides/governance/testing, guides/governance/managing | P1 | +| 40 | `guides/governance/launching.md` | Launching an SNS | how-to | advanced | Decentralize your app with an SNS. Token economics configuration, governance parameters, integration checklist, NNS proposal submission. | Portal building-apps/governing-apps/launching/ (4 files), tokenomics/ (4 files); icskills: sns-launch; examples: sns-adaptor (Rust) | concepts/governance, guides/governance/testing, guides/governance/managing | P1 | | 41 | `guides/governance/managing.md` | Managing an SNS | how-to | advanced | Operate a live SNS. Making proposals, cycles management, asset canister updates, neuron staking from CLI. | Portal building-apps/governing-apps/managing/ (4 files); icskills: sns-launch; JS SDK: @icp-sdk/canisters; examples: stake_neuron_from_cli (Rust) | guides/governance/launching, concepts/governance | P1 | | 42 | `guides/governance/testing.md` | Testing SNS Governance | how-to | advanced | Test your SNS before mainnet launch. Local testing with PocketIC, testflight on mainnet, pre-launch verification checklist. | Portal building-apps/governing-apps/testing/ (3 files); icskills: sns-launch; JS SDK: pic-js | guides/governance/launching, guides/testing/pocket-ic | P1 | @@ -149,8 +149,8 @@ | 58 | `concepts/reverse-gas-model.md` | Reverse Gas Model | explanation | beginner | Why users do not pay gas on ICP. Canisters pay cycles for compute, storage, and bandwidth. ICP-to-cycles conversion. Cost predictability. | Portal building-apps/essentials/gas-cost.mdx, getting-started/tokens-and-cycles.mdx; Learn Hub: cycles economics | guides/canister-management/cycles-management, reference/cycles-costs, concepts/canisters | P0 | | 59 | `concepts/orthogonal-persistence.md` | Orthogonal Persistence | explanation | intermediate | How canister memory survives across executions and upgrades. Stable memory, heap persistence in Motoko, stable structures in Rust. | Portal (persistence sections); Learn Hub: orthogonal persistence | guides/backends/data-persistence, languages/rust/stable-structures, guides/canister-management/lifecycle | P0 | | 60 | `concepts/chain-fusion.md` | Chain Fusion | explanation | intermediate | How ICP connects to Bitcoin, Ethereum, Solana, and other chains. Chain-key signatures, threshold ECDSA/Schnorr, HTTP outcalls to other chains, chain-key tokens. | Portal building-apps/chain-fusion/overview.mdx, supported-chains.mdx, evm-rpc/how-it-works.mdx; Learn Hub: chain-key tokens | guides/chain-fusion/bitcoin, guides/chain-fusion/ethereum, concepts/chain-key-cryptography | P0 | -| 61 | `concepts/governance.md` | Governance | explanation | intermediate | How ICP is governed. The NNS, SNS for dapp governance, neuron staking, proposals, tokenomics basics. | Portal building-apps/governing-apps/tokenomics/index.mdx; Learn Hub: NNS | guides/governance/launching, guides/governance/managing | P1 | -| 62 | `concepts/security.md` | Security Model | explanation | intermediate | The IC security model. Canister isolation, trust boundaries, certified variables, the role of boundary nodes. Threat model for dapp developers. | Portal building-apps/best-practices/trust-in-canisters.mdx; icskills: canister-security; Learn Hub: security model | guides/security/access-management, guides/security/canister-upgrades, guides/frontends/certification | P0 | +| 61 | `concepts/governance.md` | Governance | explanation | intermediate | How ICP is governed. The NNS, SNS for app governance, neuron staking, proposals, tokenomics basics. | Portal building-apps/governing-apps/tokenomics/index.mdx; Learn Hub: NNS | guides/governance/launching, guides/governance/managing | P1 | +| 62 | `concepts/security.md` | Security Model | explanation | intermediate | The IC security model. Canister isolation, trust boundaries, certified variables, the role of boundary nodes. Threat model for app developers. | Portal building-apps/best-practices/trust-in-canisters.mdx; icskills: canister-security; Learn Hub: security model | guides/security/access-management, guides/security/canister-upgrades, guides/frontends/certification | P0 | ### Languages -- Motoko (1 page, rest synced) diff --git a/AGENTS.md b/AGENTS.md index 6fc960d0..e5ffc880 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,4 +1,4 @@ -# ICP Developer Docs — Agent & Contributor Instructions +# ICP Developer Docs: Agent & Contributor Instructions ICP developer documentation built with Astro + Starlight. Content is `.md` by default. Pages that need interactive components (e.g., language-synced tabs) use `.mdx` — see `.docs-plan/decisions.md` for the policy. diff --git a/docs/guides/security/encryption.md b/docs/guides/security/encryption.md index f52916b9..fa34b18b 100644 --- a/docs/guides/security/encryption.md +++ b/docs/guides/security/encryption.md @@ -1,6 +1,6 @@ --- title: "Encryption with VetKeys" -description: "Encrypt and decrypt data on ICP using VetKeys for onchain privacy, key management, and identity-based encryption" +description: "Encrypt and decrypt data on ICP using VetKeys for privacy, key management, and identity-based encryption" sidebar: order: 6 ---