docs: refresh stale README links after the docs migration

[marc0olo]

The developer docs moved to docs.internetcomputer.org. The old internetcomputer.org/docs/current/* URLs in the README now 301 to the docs homepage, so they lose the target page entirely. This PR fixes those, plus two other stale links spotted along the way, and drops "smart contract" from the prose.

Documentation links

Old	New
.../docs/current/references/ii-spec	docs.internetcomputer.org/references/internet-identity-spec
.../docs/current/developer-docs/integrations/internet-identity/	docs.internetcomputer.org/guides/authentication/internet-identity
.../docs/current/developer-docs/build/languages/candid/candid-concepts/	docs.internetcomputer.org/guides/canister-calls/candid/

All new URLs return 200, and the #client-authentication-protocol anchor referenced from the "Integrating with Internet Identity" section still exists as a heading id on the new spec page.

Both "Internet Identity documentation" links were followed by "on internetcomputer.org", which named the wrong host once the docs moved. Rather than correct the host, the attribution is gone — repeating where a link points adds nothing.

SDK links

The Flexible bullet pointed at github.com/dfinity/agent-js, which now redirects to dfinity/icp-js-core. It links the published packages instead — @icp-sdk/auth and @icp-sdk/core, the former declaring the latter as a peer dependency — matching the @icp-sdk/auth reference further down in the README.

Terminology

Dropped the two uses of "smart contract". Both were glosses on "canister" rather than load-bearing terms — "the canister smart contract" in the Flexible bullet, and "canisters (canister smart contracts)" in the architecture overview — so removing them costs no meaning.

Deliberately not touched

• docs/ii-spec.mdx still contains docs/current/* links, and that is correct. It is the upstream source for the published spec page: developer-docs consumes it as a submodule and rewrites the links through the PATH_MAP in scripts/sync-ii-spec.mjs, which canonicalizes both the legacy and current URL forms precisely because the two repos do not migrate in lockstep. The rendered page carries no stale links. Rewriting them here would in fact break that sync — upstream's single ic-interface-spec page is split across several files on the new site, so the correct new URLs would no longer match their PATH_MAP keys and the script exits non-zero on unhandled links. Any change there has to land alongside a PATH_MAP update.
• src/frontend/src/lib/config.ts defines II_DEVELOPER_DOCS_URL, whose URL is likewise dead. It is exported but never imported anywhere in the repo — leftover from Landing Page #3341 — so nothing ships it to users. It wants deleting rather than updating; out of scope for a README PR.
• Remaining ic-interface-spec links in src/try-ii/README.md, src/sig-verifier-js/README.md, and assorted Rust/Candid doc comments are genuinely stale but cosmetic. Happy to sweep them separately.

🤖 Generated with Claude Code

[zeropath-ai]

✅ No security or compliance issues detected. Reviewed everything up to d9dfc62.

Security Overview

• 🔎 Scanned files: 1 changed file(s)
• 🔗 Scan Link: https://zeropath.com/app/repositories/6d3e3b61-710b-4b2b-9c0b-43458b6314b6?scanId=550e3d89-7f96-423e-9d5e-239f6a006806&codeScanTypes=PrScan&tab=issues

Detected Code Changes

Change Type	Relevant files
Bug Fix	► README.md     Update external links and references to newer documentation URLs

[Copilot]

Pull request overview

Updates the root README to reflect the migration of Internet Identity documentation/spec pages to docs.internetcomputer.org, and refreshes SDK references to avoid redirects and keep the README’s integration guidance current.

Changes:

• Replaced legacy internetcomputer.org/docs/current/* links with the corresponding docs.internetcomputer.org/* pages (including the spec anchor link).
• Updated the “Flexible” SDK reference from the old agent-js repo link to the published @icp-sdk/* packages.
• Refreshed reference-style link targets ([spec], [candid]) to the new documentation host.

Suppressed comments (1)

README.md:141

• This line says the documentation is “on internetcomputer.org”, but the actual URL is on docs.internetcomputer.org. Update the displayed domain/link to match the new docs host.

- [Internet Identity Documentation](https://docs.internetcomputer.org/guides/authentication/internet-identity) on [internetcomputer.org](https://internetcomputer.org)

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.