Skip to content

fix: update execution error doc links to new docs URL#10268

Open
marc0olo wants to merge 2 commits into
masterfrom
mwalz/fix-execution-error-doc-links
Open

fix: update execution error doc links to new docs URL#10268
marc0olo wants to merge 2 commits into
masterfrom
mwalz/fix-execution-error-doc-links

Conversation

@marc0olo
Copy link
Copy Markdown
Member

@marc0olo marc0olo commented May 20, 2026

Summary

All execution error messages printed by the ICP protocol include documentation links generated by the doc_ref() function in rs/types/wasm_types/src/errors.rs. These links were pointing to old URLs that are no longer valid.

Changes:

  • rs/types/wasm_types/src/errors.rs: updates the base URL in doc_ref(), fixing all 54 documentation links embedded in execution error messages across hypervisor/execution errors, Wasm validation errors, canister manager errors, and system API errors
  • rs/nervous_system/instruction_stats/src/lib.rs: updates the resource-limits link in the candid_call_instructions metric description

Note: Until this change is deployed to mainnet, the old URLs should remain reachable (e.g. via redirects) so that users on older replica versions still get valid links.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the base URL used by doc_ref() so execution error messages produced by the replica point to the new Execution Errors documentation site.

Changes:

  • Switched the Execution Errors documentation link base from internetcomputer.org/docs/current/... to docs.internetcomputer.org/....

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@marc0olo marc0olo marked this pull request as ready for review May 21, 2026 09:15
@marc0olo marc0olo requested review from a team as code owners May 21, 2026 09:15
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This pull request changes code owned by the Governance team. Therefore, make sure that
you have considered the following (for Governance-owned code):

  1. Update unreleased_changelog.md (if there are behavior changes, even if they are
    non-breaking).

  2. Are there BREAKING changes?

  3. Is a data migration needed?

  4. Security review?

How to Satisfy This Automatic Review

  1. Go to the bottom of the pull request page.

  2. Look for where it says this bot is requesting changes.

  3. Click the three dots to the right.

  4. Select "Dismiss review".

  5. In the text entry box, respond to each of the numbered items in the previous
    section, declare one of the following:

  • Done.

  • $REASON_WHY_NO_NEED. E.g. for unreleased_changelog.md, "No
    canister behavior changes.", or for item 2, "Existing APIs
    behave as before.".

Brief Guide to "Externally Visible" Changes

"Externally visible behavior change" is very often due to some NEW canister API.

Changes to EXISTING APIs are more likely to be "breaking".

If these changes are breaking, make sure that clients know how to migrate, how to
maintain their continuity of operations.

If your changes are behind a feature flag, then, do NOT add entrie(s) to
unreleased_changelog.md in this PR! But rather, add entrie(s) later, in the PR
that enables these changes in production.

Reference(s)

For a more comprehensive checklist, see here.

GOVERNANCE_CHECKLIST_REMINDER_DEDUP

marc0olo and others added 2 commits May 21, 2026 11:16
All 54 documentation links embedded in execution error messages were
pointing to `internetcomputer.org/docs/current/references/execution-errors`
which is no longer valid. Updated to `docs.internetcomputer.org/references/execution-errors`.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@marc0olo marc0olo force-pushed the mwalz/fix-execution-error-doc-links branch from 6570934 to d86d011 Compare May 21, 2026 09:16
@marc0olo marc0olo dismissed github-actions[bot]’s stale review May 21, 2026 09:18

No changelog update needed — this is purely a URL fix in a metric description string with no canister behavior change.

Copy link
Copy Markdown
Contributor

@mraszyk mraszyk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The link in "For the full specification of these constraints, see WebAssembly module requirements." is broken

@marc0olo
Copy link
Copy Markdown
Member Author

@mraszyk is this another link that needs to be updated and should be covered in this PR?

the new location is https://docs.internetcomputer.org/references/ic-interface-spec/canister-interface/#system-api-module

@mraszyk
Copy link
Copy Markdown
Contributor

mraszyk commented May 21, 2026

@mraszyk is this another link that needs to be updated and should be covered in this PR?

the new location is https://docs.internetcomputer.org/references/ic-interface-spec/canister-interface/#system-api-module

Ideally yes, please

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants