Skip to content

Restructure docs navigation around user intent#131

Merged
HDauven merged 3 commits into
mainfrom
agent/restructure-docs-navigation
Jul 14, 2026
Merged

Restructure docs navigation around user intent#131
HDauven merged 3 commits into
mainfrom
agent/restructure-docs-navigation

Conversation

@HDauven

@HDauven HDauven commented Jul 14, 2026

Copy link
Copy Markdown
Member

Summary

  • reorganize the documentation around four reader intents: Learn, Use Dusk, Build, and Operate
  • replace implementation-shaped sidebar buckets with task-oriented groups
  • add a concise Use Dusk entry page for wallets, staking, bridges, migration, and explorers
  • consolidate Dusk Wallet, Web Wallet, Rusk Wallet, and community wallet guidance into one comparison page
  • keep workflow instructions in dedicated task guides and upstream command references
  • document official mainnet/testnet explorers and clearly distinguish community-operated alternatives
  • refocus the Ecosystem page on third-party applications, wallets, network tools, initiatives, and integrations
  • align homepage, developer, operator, and machine-readable entry points with the new navigation

Rationale

The previous structure reflected how pages had accumulated rather than what readers were trying to do. User workflows were mixed into Learn, wallet products and developer integrations were easy to conflate, and thin product pages repeated instructions already covered by task guides or versioned upstream documentation.

The new structure separates conceptual learning, end-user actions, application development, and infrastructure operation. Wallet selection now happens in one place; migration, bridging, staking, and node setup remain independently maintained workflows; and community projects are listed in a clearly disclaimed ecosystem directory.

Compatibility

  • the canonical new routes are /use/overview/ and /use/wallets/
  • /learn/web-wallet/ redirects to the Web Wallet section
  • /learn/rusk-wallet/ redirects to the Rusk Wallet section
  • /use/dusk-wallet/ redirects to the Dusk Wallet section for compatibility with the earlier draft
  • all other existing content routes remain valid

Validation

  • npm run build
  • 59 pages built and 86 HTML files indexed
  • all internal links valid
  • all 56 sidebar destinations return 2xx from the local server
  • canonical pages and compatibility redirects tested locally
  • wallet, explorer, and ecosystem destinations checked directly
  • git diff --check

@HDauven
HDauven marked this pull request as ready for review July 14, 2026 21:15
@HDauven
HDauven merged commit 4667fba into main Jul 14, 2026
1 check passed
@HDauven
HDauven deleted the agent/restructure-docs-navigation branch July 14, 2026 21:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant