Skip to content

docs: fix outdated docs.near.org links in doc comments - #1591

Merged
r-near merged 1 commit into
near:masterfrom
TemRevil:docs/fix-docs-near-org-links
Jul 10, 2026
Merged

r-near merged 1 commit into
near:masterfrom
TemRevil:docs/fix-docs-near-org-links

Conversation

@TemRevil

Copy link
Copy Markdown
Contributor

Fixes #1589

The NEAR docs site restructure dropped the /build/ prefix from the smart-contract pages and moved a couple of older paths, so most docs.near.org links in our doc comments were hard 404s.

Changes (matching the table in the issue):

  • /build/smart-contracts/* → /smart-contracts/* (12 links across near-sdk/src/lib.rs, env.rs, promise.rs, store/mod.rs, storage_key_impl.rs)
  • /develop/contracts/security/random → /smart-contracts/security/random (the originally reported random_seed_array link)
  • /docs/concepts/storage-staking → /protocol/storage/storage-staking in near-contract-standards/src/lib.rs (was only a 301, updated to the canonical URL)

Every replacement URL was checked and returns 200. Anchor fragments (#promises, #payable-functions, #private-functions, #initializing-the-state) were kept since they still resolve on the new pages.

I left the nomicon.io redirects in near-contract-standards alone — they still resolve, and the issue marks them as optional cleanup.

The docs site restructure dropped the /build/ prefix from smart-contract
pages and moved a few older paths, leaving hard 404s in our doc comments.

- /build/smart-contracts/* -> /smart-contracts/* (12 links)
- /develop/contracts/security/random -> /smart-contracts/security/random
- /docs/concepts/storage-staking -> /protocol/storage/storage-staking
  (was a 301 redirect; now points at the canonical URL)

All replacement URLs verified to return 200. Anchor fragments kept as-is
since they still resolve on the new pages.
@TemRevil
TemRevil requested a review from a team as a code owner July 10, 2026 09:23
@github-project-automation github-project-automation Bot moved this to NEW❗ in DevTools Jul 10, 2026
@codecov

codecov Bot commented Jul 10, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.09%. Comparing base (de5c436) to head (7d9fc43).
⚠️ Report is 110 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #1591      +/-   ##
==========================================
+ Coverage   80.52%   81.09%   +0.56%     
==========================================
  Files         107      106       -1     
  Lines       15591    15224     -367     
==========================================
- Hits        12555    12346     -209     
+ Misses       3036     2878     -158     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@r-near

r-near commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Thanks for the contribution!

@r-near
r-near merged commit 6f311d9 into near:master Jul 10, 2026
75 checks passed
@github-project-automation github-project-automation Bot moved this from NEW❗ to Shipped 🚀 in DevTools Jul 10, 2026
This was referenced Jul 9, 2026
This was referenced Sep 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Shipped 🚀

Development

Successfully merging this pull request may close these issues.

Outdated docs.near.org links in doc comments (broken after docs site restructure)

2 participants