Skip to content

docs: review and refresh the Wallets guides (/wallets and sub-pages) #961

Description

@jim-counter

Background

This is part of the ongoing effort to make every step of staking as frictionless as possible (recently: the Staking Portal, XDM, and Wrap & Unwrap guides).

Staking starts with having a consensus-chain wallet - and often with creating a new wallet to transfer into and stake from. So the wallet docs are effectively step zero of the staking journey, and they should be accurate and easy to follow.

There is not necessarily anything wrong with the current pages - this is a review/refresh pass to validate that the process flows and screenshots are still accurate, and to update anything that has drifted.

Scope

The Wallets section and all pages beneath it:

Page Source file Screenshots
Wallets index (category landing) docs/ai3_token/wallets/_category_.json n/a
Talisman (Recommended) docs/ai3_token/wallets/talisman.md static/img/doc-imgs/talisman/
SubWallet docs/ai3_token/wallets/subwallet.mdx static/img/doc-imgs/subwallet/
Polkadot.js docs/ai3_token/wallets/polkadot.md static/img/doc-imgs/polkadot/
FoxWallet docs/ai3_token/wallets/foxwallet.md static/img/doc-imgs/foxwallet/

What to validate

  • Setup flows - install/onboarding steps match each wallet's current extension/app UI (wallet UIs change often).
  • Screenshots - each screenshot reflects the current UI; recapture and replace any that are stale. (Note: the polkadot image directory is shared with the Substrate Portal staking guide - check before deleting/renaming.)
  • Creating a new account/wallet - each guide clearly covers creating a fresh account, since a common staking flow is to transfer into and stake from a new wallet.
  • Network / RPC details - instructions for adding/selecting the Autonomys consensus chain (and any RPC endpoints shown) are current.
  • Category landing description - _category_.json currently reads "Guides on setting up SubWallet or polkadot{.js} extension wallet", which omits Talisman (the recommended one) and FoxWallet. Update to reflect all documented wallets.
  • Cross-links to the staking journey - where helpful, link onward to the Staking Portal / XDM / Wrap guides so "I have a wallet" flows naturally into "I can stake."
  • Consistency & polish - consistent naming, correct Recommended badge usage.

Acceptance criteria

  • Every page above reviewed; flows validated against the live wallet UIs and corrected where needed.
  • Stale screenshots recaptured and replaced.
  • New-account creation is covered on each page.
  • Category landing description updated.
  • yarn build passes on Node 22.14.0 (per .tool-versions) with no new broken links.

Notes

  • These docs are i18n/Crowdin-managed; edit the English source only - translations re-sync separately.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions