Verona rebrand: docs IA, narrative, and URI migration#75
Open
btspoony wants to merge 21 commits into
Open
Conversation
Mark others/resources.md as hidden in GitBook nav and point the Twitter entry to @BurntXION. Co-authored-by: Cursor <cursoragent@cursor.com>
Move xions-core to about-verona and neutralize xion-prefixed developer and node doc paths so redirects and Wave 2 content can land on stable URLs. Co-authored-by: Cursor <cursoragent@cursor.com>
Rewrite homepage and SUMMARY, expand GitBook redirects, add rebrand/surfaces/token docs, and update internal links for the new paths. Co-authored-by: Cursor <cursoragent@cursor.com>
Align the display and href URLs to @BurntXION. Co-authored-by: Cursor <cursoragent@cursor.com>
Update Truth Engine, Meta Accounts, abstraction, use cases, and glossary copy; fix broken developer links and remove Trust Layer framing. Co-authored-by: Cursor <cursoragent@cursor.com>
Refresh section READMEs, Verona Agent Toolkit branding, and production overview while preserving XION on-chain naming. Co-authored-by: Cursor <cursoragent@cursor.com>
Repair governance, Truth Engine, and join-network references; point tutorials at relative paths after the URI migration. Co-authored-by: Cursor <cursoragent@cursor.com>
Align Truth Engine wording and fix internal section links after the concept page rewrites. Co-authored-by: Cursor <cursoragent@cursor.com>
Cover legacy featured-guides, section-overview, and xions-core paths; replace the last docs.burnt.com link and archived Next Steps broken link. Co-authored-by: Cursor <cursoragent@cursor.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 22946cd57d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Contributor
There was a problem hiding this comment.
Pull request overview
This PR performs the “Verona” documentation rebrand and information-architecture migration: legacy xions-core/ conceptual docs are moved under about-verona/, navigation is reorganized, and redirects/internal links are updated so existing URLs continue to resolve while the narrative uses Verona (with XION preserved for on-chain identifiers like xiond and chain IDs).
Changes:
- Rebuilds
SUMMARY.mdto a new top-level structure (About Verona → Build on Verona → Nodes & Validators) and updates the homepage copy/cards accordingly. - Introduces new “About Verona” conceptual + narrative pages (rebrand story, surfaces, token/revenue Phase 1) and rewrites/retargets many internal links.
- Expands
.gitbook.yamlredirects to cover many legacy XION doc paths and renamed pages.
Reviewed changes
Copilot reviewed 70 out of 92 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| xions-core/concepts/README.md | Removes legacy Concepts landing page (migrated to About Verona). |
| xions-core/concepts/overview.md | Removes legacy XION overview page (migrated to About Verona). |
| SUMMARY.md | Rebuilds IA and rewires many doc paths under new sections. |
| README.md | Rewrites homepage narrative/cards for Verona + “Build on Verona”. |
| others/resources.md | Hides resources page and normalizes link formatting. |
| others/archived/old-concepts-overview.md | Updates archived links to point to About Verona concepts. |
| others/archived/cosmwasm-resources/introductory-section/README.md | Fixes “Next Steps” link from broken external to local file. |
| nodes-and-validators/run-a-node/README.md | Updates Run a Node landing copy/cards for daemon naming. |
| nodes-and-validators/run-a-node/join-the-network/README.md | Updates join-network navigation card destination. |
| nodes-and-validators/run-a-node/join-the-network/xion-testnet-1.md | Adds per-network join instructions page (currently inconsistent). |
| nodes-and-validators/run-a-node/download-the-daemon.md | Adds Docker-based daemon download instructions. |
| nodes-and-validators/run-a-node/configure-the-daemon/README.md | Adds daemon configuration overview + file links. |
| nodes-and-validators/run-a-node/configure-the-daemon/app.toml.md | Adds sample app.toml documentation. |
| nodes-and-validators/run-a-node/configure-the-daemon/client.toml.md | Adds sample client.toml documentation. |
| nodes-and-validators/run-a-node/configure-the-daemon/config.toml.md | Adds sample config.toml documentation. |
| nodes-and-validators/run-a-node/build-the-daemon.md | Adds source build instructions for xiond. |
| nodes-and-validators/become-a-validator/README.md | Updates validator landing copy/cards for rebrand conventions. |
| nodes-and-validators/become-a-validator/initial-setup.md | Updates internal link to renamed wallet-address page. |
| nodes-and-validators/become-a-validator/obtain-a-wallet-address.md | Adds wallet creation/restoration page (daemon CLI). |
| developers/overview.md | Reframes developer overview as “Build on Verona” while keeping XION precision. |
| developers/accounts/README.md | Updates Accounts section narrative + renamed paths. |
| developers/accounts/getting-started/README.md | Updates Meta Accounts concept link to About Verona. |
| developers/accounts/oauth2-app.md | Updates toolkit reference to Verona toolkit doc. |
| developers/accounts/web-app/build-react-dapp-with-account-abstraxion.md | Updates account abstraction concept link (currently incorrect relative path). |
| developers/accounts/mobile-app/README.md | Updates quick-start link (currently incorrect relative path). |
| developers/accounts/mobile-app/create-mobile-app-and-integrate-meta-account-authentication.md | Updates quick-start and deep-dive links to new paths. |
| developers/accounts/mobile-app/set-up-mobile-development-environment.md | Adds mobile dev environment setup guide. |
| developers/accounts/mobile-app/building-a-react-native-mobile-app-with-abstraxion.md | Adds Abstraxion React Native tutorial. |
| developers/accounts/backend-app/README.md | Updates backend guide link to renamed file. |
| developers/accounts/backend-app/build-restapi-with-account-abstraction-and-backend-session.md | Updates account abstraction concept link (currently points to missing file). |
| developers/accounts/backend-app/backend-using-cosmjs.md | Adds CosmJS backend integration guide. |
| developers/tools/README.md | Updates Tools & SDKs cards to renamed tool docs. |
| developers/tools/verona-toolkit.md | Renames and updates Agent Toolkit doc to Verona narrative. |
| developers/tools/daemon-cli.md | Renames daemon CLI doc title and updates internal links. |
| developers/tools/mob-signing-client.md | Adds Mob SDK overview doc with examples. |
| developers/verification/README.md | Reframes verification as Truth Engine + adds conceptual/product links. |
| developers/verification/publishing-zk-verification-keys.md | Updates concept/tool links and testnet token link. |
| developers/verification/internet-verification/README.md | Updates reclaim guide link to renamed filename. |
| developers/verification/internet-verification/zktls-integration-using-reclaim-in-a-mobile-app.md | Updates internal links; contains a typo fix opportunity. |
| developers/verification/internet-verification/zktls-integration-using-opacity-in-a-mobile-app.md | Updates mobile env guide link to renamed filename. |
| developers/computation/README.md | Updates computation section intro + quick-start/tool links. |
| developers/computation/quick-start/README.md | Converts external links to local quick-start paths. |
| developers/computation/quick-start/zero-to-dapp-in-5-minutes/README.md | Updates quick-start card links to renamed files. |
| developers/computation/quick-start/zero-to-dapp-in-5-minutes/launch-a-user-map-dapp-in-5-minutes.md | Updates many legacy external links to local paths. |
| developers/computation/quick-start/zero-to-dapp-in-5-minutes/react-native-mobile-dapp-in-5-minutes.md | Updates mobile env guide link to renamed filename. |
| developers/computation/quick-start/zero-to-dapp-in-5-minutes/build-a-todo-app-using-the-collection-document-storage-smart-contract.md | Adds TODO quick-start doc with env var examples. |
| developers/computation/use-cases/building-a-per-user-data-storage-dapp.md | Updates legacy external links to local references. |
| developers/computation/use-cases/build-a-todo-app-using-the-collection-document-storage-smart-contract.md | Updates treasury link to local doc. |
| developers/computation/local-development/deploy-a-cosmwasm-smart-contract.md | Updates setup/tooling links to local docs. |
| developers/computation/local-development/setting-up-env/setup-cosmwasm-ide.md | Updates Rust install reference to local setup section. |
| developers/computation/local-development/setting-up-env/setting-up-your-xion-smart-contract-development-environment-on-windows-wsl2-+-ubuntu.md | Updates xiond install reference to local setup section. |
| developers/computation/integrations/websockets/websockets-real-time-communication.md | Adds WebSockets integration guide (still Xion/testnet-2 wording). |
| developers/computation/integrations/token-factory/integrating-a-token-factory-token-in-a-smart-contract.md | Updates environment/tooling links to local docs. |
| developers/computation/integrations/token-factory/creating-minting-and-interacting-with-a-token-factory-token.md | Updates local setup/tooling/testnet token links. |
| developers/computation/re-using-existing-contracts/README.md | Updates mainnet guidance link to new section. |
| developers/computation/re-using-existing-contracts/deployed-contracts.md | Adds deployed contracts pointer doc (contains typos). |
| developers/payments/README.md | Updates Payments intro to “XION network” wording. |
| developers/payments/ach-and-bank-transfers/build-a-brale-ach-on-off-ramp-app.md | Updates docs resource link to Verona docs entrypoint. |
| developers/building-for-production/xion-testnet-your-development-playground.md | Removes old testnet page. |
| developers/building-for-production/testnet-playground.md | Adds new testnet overview page. |
| developers/building-for-production/README.md | Updates intro + replaces broken governance links with local docs. |
| developers/building-for-production/deploying-to-mainnet/README.md | Adds mainnet deployment overview/process page. |
| developers/building-for-production/deploying-to-mainnet/community-engagement-building-support-for-your-dapp.md | Adds community engagement guidance page. |
| developers/building-for-production/deploying-to-mainnet/smart-contract-audits-process-costs-and-support.md | Adds audits/costs/support guidance page. |
| developers/references/README.md | Rewords and updates reference cards to renamed files. |
| developers/references/testnet-tokens.md | Adds faucet instructions page. |
| developers/references/token-contract-addresses-on-evm-chains.md | Adds EVM contract address reference page. |
| developers/references/ibc-denoms.md | Adds IBC denom reference page (still references testnet-2 endpoints). |
| developers/references/frequently-asked-questions.md | Replaces legacy external links with local doc paths. |
| developers/references/for-web2-developers/README.md | Updates recommended architecture link to renamed file. |
| developers/references/for-web2-developers/recommended-architecture-for-dapps.md | Adds recommended architecture doc (still XION wording). |
| about-verona/concepts/README.md | Adds About Verona Concepts landing page. |
| about-verona/concepts/overview.md | Adds Verona overview narrative page. |
| about-verona/concepts/generalized-abstraction.md | Updates abstraction narrative to Verona/XION framing. |
| about-verona/concepts/intro-to-account-abstraction.md | Updates AA framing and fixes broken developer-section link. |
| about-verona/concepts/meta-accounts.md | Renames + updates Meta Accounts page content and links. |
| about-verona/concepts/meta-accounts-design.md | Updates heading/style + intro language for new framing. |
| about-verona/concepts/architecture-and-tech-glossary.md | Expands glossary to include Verona term and reframes section. |
| about-verona/concepts/use-cases.md | Adds agent-focused use-case section and surface links. |
| about-verona/concepts/verification-infrastructure/README.md | Reframes Truth Engine as Verona stack on XION and updates dev-doc link. |
| about-verona/concepts/verification-infrastructure/zktls.md | Updates narrative + developer documentation link. |
| about-verona/concepts/verification-infrastructure/dkim-module-zkemail.md | Updates DKIM module framing as Truth Engine pillar. |
| about-verona/concepts/verification-infrastructure/app-attestations.md | Updates App Attestations framing as Truth Engine module. |
| about-verona/rebrand-from-xion.md | Adds rebrand explainer page (contains incorrect relative link). |
| about-verona/surfaces/README.md | Adds Surfaces index page (EarnOS, Burnt Verified, Ask & MCP, Data Backpack). |
| about-verona/surfaces/earnos.md | Adds EarnOS surface page + dev integration pointers. |
| about-verona/surfaces/burnt-verified.md | Adds Burnt Verified surface page + module entrypoints. |
| about-verona/surfaces/ask-and-mcp.md | Adds Ask/MCP narrative page + tooling pointers. |
| about-verona/surfaces/data-backpack.md | Adds Data Backpack narrative page + composition guidance. |
| about-verona/token-and-revenue.md | Adds Phase 1 token/revenue narrative (contains incorrect relative links). |
| about-verona/ai-agents.md | Updates AI agent quick-start to Verona toolkit narrative. |
| .gitbook.yaml | Adds many redirects for renamed/migrated URLs (xions-core, tools, quick-start, nodes, references, etc.). |
Comments suppressed due to low confidence (2)
nodes-and-validators/run-a-node/join-the-network/README.md:23
- This card labels the network as
xion-testnet-1and links toxion-testnet-1.md, but the network selection table above still listsxion-testnet-2and its genesis/snapshot URLs. Please align the table + card + per-network page so they all refer to the same chain ID and instruction set.
developers/verification/internet-verification/zktls-integration-using-reclaim-in-a-mobile-app.md:49 - Typo: "ion JSON format" should be "in JSON format".
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Remove unconfirmed homepage proof points, tighten network/layer language, soften Ask MCP availability, and refresh Build landing copy around reusable verified facts. Co-authored-by: Cursor <cursoragent@cursor.com>
Correct relative links flagged in review, align node join docs to xion-testnet-2, and fix the Reclaim JSON typo. Co-authored-by: Cursor <cursoragent@cursor.com>
This content is not appropriate for the docs site audience; drop the page, nav entry, redirect, and EarnOS cross-link. Co-authored-by: Cursor <cursoragent@cursor.com>
Use Verona for product and network prose while keeping XION for on-chain identifiers, CLI names, and token symbols. Co-authored-by: Cursor <cursoragent@cursor.com>
Use Developer Portal, Verona forum, Verona Faucet, and Verona Configuration in developer guides. Co-authored-by: Cursor <cursoragent@cursor.com>
Keep directional surfaces and use cases scoped to approved developer-facing claims. Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 98 out of 110 changed files in this pull request and generated 6 comments.
Comments suppressed due to low confidence (4)
developers/tools/daemon-cli.md:9
- This CLI page is part of the on-chain/ops surface (
xiond), but it currently says it interacts with the Verona network while the frontmatter and PR description indicate on-chain/CLI naming should remain XION. Consider describing it as the XION blockchain CLI (with a note that Verona is the narrative brand) to avoid ambiguity for operators.
developers/computation/quick-start/zero-to-dapp-in-5-minutes/react-native-mobile-dapp-in-5-minutes.md:4 - This page header is Verona-branded, but the first sentence still says “Building a Mobile App on XION…”, which reads like a leftover from the pre-rebrand version. Align the intro with the Verona narrative while keeping XION for chain/CLI precision.
developers/computation/quick-start/zero-to-dapp-in-5-minutes/launch-a-user-map-dapp-in-5-minutes.md:53 - This sentence has a duplicated phrase (“will you will”) that makes it hard to read.
developers/building-for-production/deploying-to-mainnet/README.md:42 - This bullet says the Discourse link is on the “Verona forum”, but the URL and the rest of this page are branded as Xion Mainnet governance. Using “Xion forum” here avoids implying a separate forum/site.
Update the legacy GitBook redirect, align quick-start and IBC wording, and correct tutorial typos. Co-authored-by: Cursor <cursoragent@cursor.com>
Replace XION prose with Verona, adopt $VER (Previously $XION) where relevant, and simplify the onboarding README without rebrand or chain-identifier details. Co-authored-by: Cursor <cursoragent@cursor.com>
Cover mainnet subpages, quick-start todo guide, daemon config toml files, and legacy backend/learn URLs. Co-authored-by: Cursor <cursoragent@cursor.com>
Standardize token references from $VER to $VERONA, clarify rebrand as rename-not-migration, update glossary gasless framing, and add remaining legacy URL redirects. Co-authored-by: Cursor <cursoragent@cursor.com>
Sync narrative with website copy, consolidate SUMMARY navigation, move rebrand page to Others, and streamline use cases. Co-authored-by: Cursor <cursoragent@cursor.com>
Add network economics and Phase 2 clarity, Ero launch framing, and validator continuity notes for the rename. Co-authored-by: Cursor <cursoragent@cursor.com>
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
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
xions-core/toabout-verona/and neutralize ~30 developer/node doc paths (verona-toolkit.md,quick-start/, daemon paths, etc.).SUMMARY.mdto About Verona → Build on Verona → Nodes & Validators; rewrite homepage and add Phase 1 About pages (rebrand story, surfaces, token/revenue)..gitbook.yamlredirects for legacyxions-core,featured-guides,section-overview, andlearn-and-buildURLs.Test plan
xions-core/concepts/overview,developers/tools/xion-toolkit,developers/section-overview/xion-testnet)xion-testnet-1, IBC relayer, andxiondreferences unchanged where requiredMade with Cursor