Skip to content

infra: remove migrating-from-dfx page, link to canonical CLI docs#140

Merged
marc0olo merged 1 commit into
mainfrom
infra/tools-nav-cleanup
Apr 24, 2026
Merged

infra: remove migrating-from-dfx page, link to canonical CLI docs#140
marc0olo merged 1 commit into
mainfrom
infra/tools-nav-cleanup

Conversation

@marc0olo
Copy link
Copy Markdown
Member

Summary

  • Moves the icp-cli full documentation link to the first prose mention of icp-cli in overview.md (instead of a standalone line after installation)
  • Deletes docs/guides/tools/migrating-from-dfx.md entirely — this file was synced from dfinity/icp-cli and was prone to drift; the migration guide now links directly to the canonical source at https://cli.internetcomputer.org/0.2/migration/from-dfx
  • Updates the migration note placement: moved above "Telemetry opt-out" at the end of the icp-cli intro

Sync recommendation

docs/guides/tools/overview.mdinformed by dfinity/icp-cli
docs/guides/tools/migrating-from-dfx.md — deleted; canonical content lives at https://cli.internetcomputer.org/0.2/migration/from-dfx

Move the icp-cli docs link to the first mention of icp-cli in overview.md
rather than a standalone line after installation. Remove the local
migrating-from-dfx.md (which was synced from dfinity/icp-cli and prone
to drift) and replace the in-page reference with a direct link to the
canonical migration guide at cli.internetcomputer.org.
@marc0olo marc0olo merged commit beba385 into main Apr 24, 2026
2 checks passed
@marc0olo marc0olo deleted the infra/tools-nav-cleanup branch April 24, 2026 11:55
marc0olo added a commit that referenced this pull request Apr 24, 2026
- Remove standalone ic-wasm section (duplicate install commands); fold
  description into the icp-cli install block as an inline note
- Add Client libraries section covering the @icp-sdk JS/TS packages
  (agent, candid, principal, identity, auth, bindgen) with link to
  js.icp.build for full docs
- Add Testing tools section covering PocketIC with install table for
  Rust (pocket-ic), JS/TS (@dfinity/pic), and Python client libraries
- Apply pending fixes from #140: move full-docs link to first icp-cli
  mention, replace local migrating-from-dfx link with external URL
- Update description and intro paragraph to reflect new sections
marc0olo added a commit that referenced this pull request Apr 24, 2026
#141)

## Summary

- **ic-wasm**: removed the standalone `### ic-wasm` section (its install
commands duplicated the icp-cli block). Description folded into the
icp-cli install section as an inline note — most users never invoke it
directly.
- **Client libraries** (new section): covers the `@icp-sdk` JS/TS
packages — `core/agent`, `core/candid`, `core/principal`,
`core/identity`, `@icp-sdk/auth`, and `@icp-sdk/bindgen` — with a
quick-reference table and link to [js.icp.build](https://js.icp.build)
for full docs.
- **Testing tools** (new section): covers PocketIC with an install table
for the Rust (`pocket-ic`), JS/TS (`@dfinity/pic`), and Python client
libraries, linking to the existing PocketIC guide.
- Also applies pending fixes from #140 (move full-docs link to first
icp-cli mention, replace local `migrating-from-dfx.md` link with
external URL at cli.internetcomputer.org).

## Sync recommendation

`informed by dfinity/icp-js-sdk-docs` — core/latest.zip,
auth/latest.zip, bindgen/latest.zip, pic-js/latest.zip
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