fix(governance): rebase, rename sns-dao-settings, add sidebar entries, image, and asset term cleanup

- Rebase onto infra/learn-hub-migration-prep (picks up batches 1–8)
- Rename docs/references/sns-dao-settings.md → sns-settings.md and update all references
- Add concepts/sns-framework, references/nns-proposal-types, references/sns-settings to sidebar
- Download and add missing SNS rewards graph image (graph_rewards_total_supply.png)
- Reduce over-use of "digital asset" → "asset" in governance.md, sns-framework.md, and sns-settings.md

Author: marc0olo

docs/concepts/governance.md

@@ -82,7 +82,7 @@ The reward rate declines over time as the protocol matures, converging toward a
 
 ## The Service Nervous System
 
-The SNS is a governance framework that allows app developers to create a community-governed SNS for their application. When an app is governed by an SNS, digital asset holders vote on proposals to upgrade the app's canisters, manage treasury funds, and adjust governance parameters.
+The SNS is a governance framework that allows app developers to create a community-governed SNS for their application. When an app is governed by an SNS, asset holders vote on proposals to upgrade the app's canisters, manage treasury funds, and adjust governance parameters.
 
 Unlike the NNS, which is a singleton governing the entire protocol, each SNS is a separate set of canisters specific to one app. SNSes live on a dedicated SNS subnet.
 
@@ -95,25 +95,25 @@ An SNS consists of five core canisters plus a variable number of archive caniste
 | **Governance** | Proposal submission, voting, neuron management |
 | **Ledger** | SNS asset transfers (ICRC-1 standard) |
 | **Root** | Sole controller of all app canisters post-launch |
-| **Swap** | Runs the decentralization swap (ICP for SNS digital assets) |
+| **Swap** | Runs the decentralization swap (ICP for SNS assets) |
 | **Index** | Transaction indexing for the SNS ledger |
 | **Archive** (one or more, spawned as needed) | Historical ledger block storage; new archive canisters are created automatically as the ledger grows |
 
-Once an SNS is live, the SNS Root canister is the sole controller of the app's canisters. Upgrades happen through governance proposals voted on by SNS digital asset holders.
+Once an SNS is live, the SNS Root canister is the sole controller of the app's canisters. Upgrades happen through governance proposals voted on by SNS asset holders.
 
 ### Digital asset economics
 
 Each SNS has its own governance digital asset. The initial distribution is defined in the SNS configuration file and includes:
 
-- **Developer neurons**: Digital assets allocated to the original developers and seed funders, typically with vesting periods and dissolve delays to signal long-term commitment.
-- **Treasury**: Digital assets owned by the SNS governance canister, spendable by governance proposal.
-- **Swap allocation**: Digital assets sold during the decentralization swap in exchange for ICP.
+- **Developer neurons**: Assets allocated to the original developers and seed funders, typically with vesting periods and dissolve delays to signal long-term commitment.
+- **Treasury**: Assets owned by the SNS governance canister, spendable by governance proposal.
+- **Swap allocation**: Assets sold during the decentralization swap in exchange for ICP.
 
 The SNS ledger implements the ICRC-1 standard. SNS neurons work similarly to NNS neurons: stake governs voting power, dissolve delay grants a bonus (up to 2x at the configured maximum), and age grants an additional bonus.
 
 ### The decentralization swap
 
-The decentralization swap is the mechanism by which SNS digital assets are distributed to the public. Participants send ICP to the SNS Swap canister during the swap window; when the swap closes, the exchange rate is determined and participants receive SNS digital assets in a basket of neurons with vesting schedules.
+The decentralization swap is the mechanism by which SNS assets are distributed to the public. Participants send ICP to the SNS Swap canister during the swap window; when the swap closes, the exchange rate is determined and participants receive SNS assets in a basket of neurons with vesting schedules.
 
 The swap has minimum and maximum ICP participation thresholds. If the minimum is not reached, the swap fails: all ICP is refunded and control of the app returns to the original developers (via the fallback controllers defined in the configuration). If the maximum is reached before the end time, the swap closes early.
 
@@ -126,7 +126,7 @@ SNS governance mirrors the NNS design but is customized per app:
 | Aspect | NNS | SNS |
 |--------|-----|-----|
 | What it governs | Protocol and network | A specific app |
-| Digital asset | ICP | Project-specific ICRC-1 digital asset |
+| Digital asset | ICP | Project-specific ICRC-1 asset |
 | Governance canisters | Singleton on NNS subnet | Per-app on SNS subnet |
 | Launch authority | N/A (pre-existing) | NNS must approve creation |
 | Proposal types | Protocol updates, subnet management, economics | App upgrades, treasury transfers, parameter changes |
@@ -138,10 +138,10 @@ When an app is governed by an SNS, the original developers no longer have direct
 - **Upgrades require proposals**: All changes to app canisters must go through SNS governance votes. Development slows down compared to centralized control.
 - **Treasury spending requires votes**: Any use of SNS treasury funds requires a governance proposal.
 - **Upgrade path is transparent**: Community members can verify new canister wasm modules before voting. Reproducible builds allow independent verification.
-- **Responsibility is distributed**: Post-launch, the development team typically continues leading the project but must engage the community of digital asset holders for major decisions.
+- **Responsibility is distributed**: Post-launch, the development team typically continues leading the project but must engage the community of asset holders for major decisions.
 - **Custom proposals**: Apps can register custom proposal types (generic functions) that allow the SNS to call specific canister methods, enabling fine-grained governance without unrestricted code upgrades.
 
-Developers preparing for an SNS launch should ensure their codebase is stable, open-sourced, and reproducibly buildable before the decentralization swap. The NNS community votes on the creation proposal and expects evidence of product-market fit, sound digital asset economics, and a realistic roadmap.
+Developers preparing for an SNS launch should ensure their codebase is stable, open-sourced, and reproducibly buildable before the decentralization swap. The NNS community votes on the creation proposal and expects evidence of product-market fit, sound asset economics, and a realistic roadmap.
 
 ## Neuron hotkeys
 

docs/concepts/sns-framework.md

@@ -3,7 +3,7 @@ title: "SNS Framework"
 description: "How the Service Nervous System works: framework architecture, launch process, neurons, proposals, and configurable rewards"
 ---
 
-The Service Nervous System (SNS) is a governance framework built into ICP that lets any developer hand control of their application to a community-governed SNS. When an app is governed by an SNS, all upgrades, treasury decisions, and parameter changes require onchain proposals voted on by SNS digital asset holders.
+The Service Nervous System (SNS) is a governance framework built into ICP that lets any developer hand control of their application to a community-governed SNS. When an app is governed by an SNS, all upgrades, treasury decisions, and parameter changes require onchain proposals voted on by SNS asset holders.
 
 For a high-level introduction comparing the NNS and SNS, see [Governance](governance.md#the-service-nervous-system).
 
@@ -28,7 +28,7 @@ Launching an SNS is a one-time process that transfers control of an application
 
 **Step 2: SNS canisters deployed:** The NNS uses SNS-W to deploy a fresh set of SNS canisters. The app's canisters are transferred to SNS Root as their controller.
 
-**Step 3: Decentralization swap:** A swap window opens where users can send ICP to the SNS Swap canister. At the end of the window (or earlier if the maximum is reached), each contributor receives a proportional share of a fixed SNS digital asset allocation as staked neurons. The ICP collected becomes the SNS treasury. All swap participants receive a basket of neurons with configurable dissolve delays.
+**Step 3: Decentralization swap:** A swap window opens where users can send ICP to the SNS Swap canister. At the end of the window (or earlier if the maximum is reached), each contributor receives a proportional share of a fixed SNS asset allocation as staked neurons. The ICP collected becomes the SNS treasury. All swap participants receive a basket of neurons with configurable dissolve delays.
 
 The swap has a minimum and maximum ICP threshold:
 - If the minimum is not met when the window closes, the swap fails: all ICP is refunded and control of the app reverts to the original fallback controllers.
@@ -45,7 +45,7 @@ Each SNS consists of five core canisters and a variable number of archive canist
 | Canister | Purpose |
 |---|---|
 | **Governance** | Stores proposals and neurons; executes adopted proposals; calculates voting power and rewards. |
-| **Ledger** | ICRC-1 ledger for the SNS's governance digital asset. |
+| **Ledger** | ICRC-1 ledger for the SNS's governance asset. |
 | **Root** | Sole controller of the governed app canisters; orchestrates canister upgrades. |
 | **Swap** | Runs the decentralization swap during launch. |
 | **Index** | Organizes ledger transactions by account for wallet and explorer queries. |
@@ -64,7 +64,7 @@ SNS neurons work similarly to NNS neurons, with a few differences:
 - Maximum dissolve delay and the bonus it grants at that maximum (default: 8 years, 2x).
 - Maximum age and the bonus it grants at that maximum (default: 4 years, 1.25x).
 
-**Maturity.** If an SNS activates voting rewards, neurons accumulate maturity that can be disbursed (minted as digital assets), staked into the neuron for compounding, or auto-staked. The same maturity modulation mechanism as the NNS applies (±5% based on recent ICP/XDR rate movements).
+**Maturity.** If an SNS activates voting rewards, neurons accumulate maturity that can be disbursed (minted as new assets), staked into the neuron for compounding, or auto-staked. The same maturity modulation mechanism as the NNS applies (±5% based on recent ICP/XDR rate movements).
 
 ## SNS proposals
 
@@ -100,7 +100,7 @@ All SNS instances include a standard set of built-in proposal types:
 - Proposals to change governance settings and SNS metadata.
 - Proposals to upgrade the SNS framework canisters.
 - Proposals to register or deregister governed app canisters.
-- Proposals to transfer treasury funds or mint new digital assets.
+- Proposals to transfer treasury funds or mint new assets.
 
 ### Custom proposals
 
@@ -118,14 +118,16 @@ Each SNS independently decides whether to enable voting rewards, and if so, what
 
 The formula between `t_start` and `t_start + t_delta` is: `R(t) = r_min + (r_max − r_min) × [(t_start + t_delta − t) / t_delta]²`. After `t_start + t_delta`, the rate is constant at `r_min`.
 
+![SNS voting rewards: new assets are distributed from the reward pool to voting neurons, while the total supply grows as rewards are distributed](/concepts/sns-framework/rewards-total-supply.png)
+
 If `VotingRewardsParameters` is not set at all, voting rewards are disabled.
 
-User rewards (distributing existing treasury digital assets to active app users) are a separate mechanism: an SNS-controlled canister holds a digital asset reserve and pays out rewards according to its own logic.
+User rewards — distributing existing treasury assets to active app users — are a separate mechanism: an SNS-controlled canister holds an asset reserve and pays out rewards according to its own logic.
 
 ## Next steps
 
 - [Governance](governance.md): NNS and SNS overview, including neurons, proposals, and voting rewards
-- [SNS settings reference](../references/sns-dao-settings.md): all configurable nervous system parameters
+- [SNS settings reference](../references/sns-settings.md): all configurable nervous system parameters
 - [Launch an SNS](../guides/governance/launching.md): step-by-step guide to the decentralization process
 - [Manage a live SNS](../guides/governance/managing.md): proposals, upgrades, and treasury management after launch
 

docs/guides/governance/managing.md

@@ -121,7 +121,7 @@ type NervousSystemParameters = record {
 };
 ```
 
-For a description of each parameter and its effect, see the [SNS DAO settings reference](../../references/sns-dao-settings.md).
+For a description of each parameter and its effect, see the [SNS settings reference](../../references/sns-settings.md).
 
 ### ManageSnsMetadata
 

docs/references/sns-dao-settings.md docs/references/sns-settings.mddocs/references/sns-dao-settings.md renamed to docs/references/sns-settings.md

@@ -3,15 +3,15 @@ title: "SNS Settings"
 description: "Reference for all SNS nervous system parameters (NervousSystemParameters)"
 ---
 
-Each SNS is customized through its **nervous system parameters**, also called SNS settings. These parameters govern voting power calculation, governance rules, digital asset economics, and reward behavior. Parameters are set at launch and can be changed by governance proposal at any time.
+Each SNS is customized through its **nervous system parameters**, also called SNS settings. These parameters govern voting power calculation, governance rules, asset economics, and reward behavior. Parameters are set at launch and can be changed by governance proposal at any time.
 
 For background, see [SNS framework](../concepts/sns-framework.md).
 
 ## Neuron settings
 
 | Parameter | Type | Description |
 |---|---|---|
-| `neuron_minimum_stake_e8s` | `nat64` | Minimum number of e8s (10⁻⁸ of the SNS digital asset) that can be staked in a neuron. Must be larger than `transaction_fee_e8s`. |
+| `neuron_minimum_stake_e8s` | `nat64` | Minimum number of e8s (10⁻⁸ of the SNS asset) that can be staked in a neuron. Must be larger than `transaction_fee_e8s`. |
 | `max_number_of_neurons` | `nat64` | Maximum number of neurons allowed. New neurons are blocked once this ceiling is reached. Ceiling: 200,000. |
 | `max_number_of_principals_per_neuron` | `nat64` | Maximum number of principals that can hold permissions for a single neuron. |
 | `neuron_claimer_permissions` | permission set | The set of permissions automatically granted to the principal that claims a new neuron. |

public/concepts/sns-framework/rewards-total-supply.png

@@ -119,6 +119,7 @@ export const sidebar = [
       { slug: "concepts/vetkeys" },
       { slug: "concepts/security" },
       { slug: "concepts/governance" },
+      { slug: "concepts/sns-framework" },
       { slug: "concepts/network-economics" },
       { slug: "concepts/ledgers" },
     ],
@@ -166,6 +167,8 @@ export const sidebar = [
     items: [
       { slug: "references/management-canister" },
       { slug: "references/system-canisters" },
+      { slug: "references/nns-proposal-types" },
+      { slug: "references/sns-settings" },
       { slug: "references/protocol-canisters" },
       { slug: "references/application-canisters" },
       { slug: "references/icrc-standards" },