diff --git a/docs/vocabulary-registry.md b/docs/vocabulary-registry.md new file mode 100644 index 0000000..da02988 --- /dev/null +++ b/docs/vocabulary-registry.md @@ -0,0 +1,65 @@ +# EDUT Vocabulary Registry (v1) + +This registry defines canonical naming across user-facing copy, support language, and technical implementation. + +Rule: one concept -> one preferred user phrase. + +## Identity and Access + +1. User-facing: `EDUT ID` + Technical: `membership` (current code key and route family) + Notes: Use `EDUT ID` in all UI/legal/public copy. Keep technical names stable until intentional internal refactor. + +2. User-facing: `EDUT ID activation` + Technical: `membership activation`, `membership mint` + Notes: One-time purchase event, non-recurring. + +3. User-facing: `EDUT ID active` + Technical: `membership_active` + Notes: Binary status text for user surfaces. + +4. User-facing: `designation` + Technical: `designation_code`, `designation_token` + Notes: Keep visible only when needed for evidence/diagnostics. + +## Commerce and Runtime + +1. User-facing: `license` + Technical: `entitlement` + Notes: Keep license language in customer copy; entitlement remains implementation object. + +2. User-facing: `workspace` + Technical: `org_root_id`, `workspace_id` + Notes: Avoid exposing raw boundary identifiers in default UI. + +3. User-facing: `Auto capacity` (or approved SKU title) + Technical: `lane`, `lane24` + Notes: Avoid exposing `lane` as a default UI term outside diagnostics/trust surfaces. + +4. User-facing: `offline continuity` + Technical: `sovereign`, `capsule` + Notes: Reserve `sovereign/capsule` for technical docs unless explicitly required. + +## Terms To Keep Out of Default User Surfaces + +1. `member_only` +2. `workspace_member` +3. `org_root_owner` +4. `connector_surface` +5. `pacing_tier` +6. `membership_*` internals + +These remain valid in API contracts, logs, conformance vectors, and implementation docs. + +## Change Discipline + +1. Copy-only rename pass: user-facing surfaces first. +2. Internal rename pass: only when routes/schemas/contracts are versioned for a clean break. +3. Never mix names in one surface (`Membership` and `EDUT ID` together is prohibited). + +## Inline Glossary Pattern + +1. Keep technically accurate terms in UI when possible. +2. Add a small help icon next to the term. +3. Help text must be one sentence, plain language, no jargon. +4. Use glossary help instead of inventing alternate names that diverge from implementation language. diff --git a/public/downloads/android/index.html b/public/downloads/android/index.html index 8cff867..8dbf852 100644 --- a/public/downloads/android/index.html +++ b/public/downloads/android/index.html @@ -71,13 +71,13 @@
membership channel verification
+EDUT ID channel verification
Android delivery is tied to wallet-authenticated membership state.
+Android delivery is tied to wallet-authenticated EDUT ID state.
Membership verified. Android distribution remains staged by designation era.
+EDUT ID verified. Android distribution remains staged by designation era.
When your channel opens, this endpoint delivers current install instructions for Android onboarding.
Member updates and entitlement notices are delivered inside the EDUT app after wallet sign-in.
membership channel verification
+EDUT ID channel verification
Desktop delivery is tied to wallet-authenticated membership state.
+Desktop delivery is tied to wallet-authenticated EDUT ID state.
Membership verified. Desktop distribution remains staged by designation era.
+EDUT ID verified. Desktop distribution remains staged by designation era.
When your channel opens, this endpoint delivers the current installer package and checksum manifest.
Member updates and entitlement notices are delivered inside the EDUT app after wallet sign-in.
membership channel verification
+EDUT ID channel verification
iOS delivery is tied to wallet-authenticated membership state.
+iOS delivery is tied to wallet-authenticated EDUT ID state.
Membership verified. iOS distribution remains staged by designation era.
+EDUT ID verified. iOS distribution remains staged by designation era.
When your channel opens, this endpoint delivers current install instructions for iOS onboarding.
Member updates and entitlement notices are delivered inside the EDUT app after wallet sign-in.
We may use information we collect to operate, maintain, and improve our websites, products, and services; process transactions and send related confirmations, invoices, and receipts; communicate with you regarding security, operations, product updates, and support; analyze reliability and usage trends; detect and prevent fraud, abuse, and unauthorized access; comply with legal obligations; and enforce our agreements.
-Verified-channel purpose. Where designation workflows are used, we process cryptographic signature data to confirm wallet control, prevent automated abuse, bind protocol records to a stable identity anchor, and maintain auditable activation continuity. Member operational notices are delivered through platform software after wallet sign-in.
+Verified-channel purpose. Where designation workflows are used, we process cryptographic signature data to confirm wallet control, prevent automated abuse, bind protocol records to a stable identity anchor, and maintain auditable activation continuity. EDUT ID operational notices are delivered through platform software after wallet sign-in.
Wallet addresses and related signature metadata may be processed to verify cryptographic intent and establish designation records. Public blockchain networks are independently operated systems; if designation or licensing records are written on-chain, related transaction data may be publicly visible and immutable by design. We do not control third-party blockchain explorers or wallet software.
diff --git a/public/store/index.html b/public/store/index.html index 389906f..8fbc4f9 100644 --- a/public/store/index.html +++ b/public/store/index.html @@ -4,7 +4,7 @@