Fix 404 links in .NET zero-code troubleshooting docs

[Copilot]

Three URLs in the .NET zero-code troubleshooting page point to files removed from open-telemetry/opentelemetry-dotnet-instrumentation by PR #4783 (2026-03-30), which eliminated the DOTNET_ADDITIONAL_DEPS/DOTNET_SHARED_STORE mechanism.

Changes

• content/en/docs/zero-code/dotnet/troubleshooting.md and content/fr/docs/zero-code/dotnet/troubleshooting.md: Replace three blob/main/... links with pinned commit-SHA URLs pointing to the last commit at which each file existed:

  • Directory.Build.props → pinned to c27acd9
  • AdditionalDeps/Directory.Packages.props → pinned to f2d70bd
  • netfx_assembly_redirection.h → pinned to 62b4a6a

• static/refcache.json: Remove the three 404 entries for the old blob/main/... URLs so the link checker stops failing on them.

Original prompt

Context

PR #9679 (branch otelbot/refcache-refresh) is a refcache refresh PR, and its link-checking CI is failing because three URLs in the docs/zero-code/dotnet/troubleshooting/ page return HTTP 404.

The three failing URLs all point to files that were removed from open-telemetry/opentelemetry-dotnet-instrumentation on the main branch by PR open-telemetry/opentelemetry-dotnet-instrumentation#4783 (commit ad0c2dc720bab8d920de8bdbcef226596fd257b0, 2026-03-30), which eliminated the DOTNET_ADDITIONAL_DEPS/DOTNET_SHARED_STORE mechanism.

Failing URLs and their replacements

The fix is to update each URL to pin to the last commit SHA at which the file still existed:

1. Directory.Build.props

   • Failing: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Build.props
   • Replace with: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/c27acd9bd0f82de47217fba660d9f979e0a0cc2d/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Build.props

2. Directory.Packages.props (AdditionalDeps)

   • Failing: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Packages.props
   • Replace with: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/f2d70bd0f095852bf0270aad61b60dfe1ea7834f/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Packages.props

3. netfx_assembly_redirection.h

   • Failing: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.Native/netfx_assembly_redirection.h
   • Replace with: https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/62b4a6a855608a925caeea95752167df5a0960a0/src/OpenTelemetry.AutoInstrumentation.Native/netfx_assembly_redirection.h

Files to edit

Update the URLs in both language versions of the troubleshooting page:

• content/en/docs/zero-code/dotnet/troubleshooting.md
• content/fr/docs/zero-code/dotnet/troubleshooting.md

(Check for any other language versions under content/*/docs/zero-code/dotnet/troubleshooting.md that contain these same links and update them too.)

Refcache update

After updating the markdown sources, update static/refcache.json:

• Remove the three failing URL entries (with blob/main/...) if present.
• The new pinned URLs will be picked up naturally by the refcache refresher on next run, but if refcache entries for the pinned URLs are not already present, no action is needed — htmltest will populate them.

Acceptance criteria

• All three failing URLs on docs/zero-code/dotnet/troubleshooting/ are replaced with the pinned commit-SHA URLs listed above, in all language variants of the file.
• static/refcache.json no longer contains entries for the three failing blob/main/... URLs.
• The htmltest/link-check CI job on the PR passes for these three URLs.

Base branch

Target this patch at the existing PR branch otelbot/refcache-refresh (PR #9679) so it lands in that PR.

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: Link checking is failing. From this log we see the 404s:

docs/zero-code/dotnet/troubleshooting/index.html
  fresh --- docs/zero-code/dotnet/troubleshooting/index.html --> https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Build.props
  hitting --- docs/zero-code/dotnet/troubleshooting/index.html --> https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Build.props
  Non-OK status: 404 --- docs/zero-code/dotnet/troubleshooting/index.html --> https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Build.props
  fresh --- docs/zero-code/dotnet/troubleshooting/index.html --> https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Packages.props
  hitting --- docs/zero-code/dotnet/troubleshooting/index.html --> https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Packages.props
  Non-OK status: 404 --- docs/zero-code/dotnet/troubleshooting/index.html --> https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/src/OpenTelemetry.AutoInstrumentation.AdditionalDeps/Directory.Packages.props
  fresh --- docs/zero-code/dotnet/troubleshooting/index.html --> https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/b...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

*This pull request was created from Copilot chat.*
>

[chalin]

/fix:refcache

[otelbot-docs]

✅ fix:refcache applied successfully in run 24776044256.

[chalin]

Only link fixes by pinning failing GH URLs to the last hash at which the given resource was valid. Approving for all SIGs and locales.

Feedback is still welcome.

Thanks @martincostello for the approval.

/cc @vitorvasc

[chalin]

Thanks @jaydeluca for the review.

[chalin]

Btw, this is a patch PR over:

• Refresh refcache #9679