Fix pre-existing broken links across documentation

docs/build/README.md

@@ -96,7 +96,7 @@ There is also a subsection of example Clarity contracts where you'll find **star
 
 We all have different styles of learning. If you've already got a good concept of web3 fundamentals and want to get a quick taste of what the DevEx is like on Stacks, then check out the [Developer Quickstart](get-started/developer-quickstart.md). Or find the path that clicks for you — and if bandwidth allows, tackle them all!
 
-<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><strong>Try the Developer Quickstart</strong></h4></td><td>Your 0→1 guide for building a Clarity contract and app on Stacks.</td><td><a href="get-started/developer-quickstart.md">developer-quickstart.md</a></td></tr><tr><td><h4><strong>Start Learning Clarity</strong></h4></td><td>An easy starting point for learning smart contracts.</td><td><a href="get-started/clarity-crash-course.md">clarity-crash-course.md</a></td></tr><tr><td><h4><strong>Bitcoin Primer Tutorial</strong></h4></td><td>A comprehensive end-to-end experience to building full-stack dApps on Bitcoin.</td><td><a href="https://app.gitbook.com/s/skGYu79qDNfITOqDNU3s/bitcoin-primer">Bitcoin Primer</a></td></tr><tr><td><h4><strong>Earn a Stacks Developer Degree</strong></h4></td><td>A hands-on Stacks bootcamp by LearnWeb3.</td><td><a href="https://learnweb3.io/degrees/stacks-developer-degree/">https://learnweb3.io/degrees/stacks-developer-degree/</a></td></tr><tr><td><h4><strong>Watch Our Hands-On Videos</strong></h4></td><td>Developer insights and workshops from the Stacks ecosystem</td><td><a href="https://www.youtube.com/@stacks-developers">https://www.youtube.com/@stacks-developers</a></td></tr><tr><td><h4><strong>Clarity Development Using Clarinet</strong></h4></td><td>The smart contract toolkit for Stacks</td><td><a href="/broken/pages/UK5Kgh2MHLoQvfoFVnLr">Broken link</a></td></tr></tbody></table>
+<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><strong>Try the Developer Quickstart</strong></h4></td><td>Your 0→1 guide for building a Clarity contract and app on Stacks.</td><td><a href="get-started/developer-quickstart.md">developer-quickstart.md</a></td></tr><tr><td><h4><strong>Start Learning Clarity</strong></h4></td><td>An easy starting point for learning smart contracts.</td><td><a href="get-started/clarity-crash-course.md">clarity-crash-course.md</a></td></tr><tr><td><h4><strong>Bitcoin Primer Tutorial</strong></h4></td><td>A comprehensive end-to-end experience to building full-stack dApps on Bitcoin.</td><td><a href="https://app.gitbook.com/s/skGYu79qDNfITOqDNU3s/bitcoin-primer">Bitcoin Primer</a></td></tr><tr><td><h4><strong>Earn a Stacks Developer Degree</strong></h4></td><td>A hands-on Stacks bootcamp by LearnWeb3.</td><td><a href="https://learnweb3.io/degrees/stacks-developer-degree/">https://learnweb3.io/degrees/stacks-developer-degree/</a></td></tr><tr><td><h4><strong>Watch Our Hands-On Videos</strong></h4></td><td>Developer insights and workshops from the Stacks ecosystem</td><td><a href="https://www.youtube.com/@stacks-developers">https://www.youtube.com/@stacks-developers</a></td></tr><tr><td><h4><strong>Clarity Development Using Clarinet</strong></h4></td><td>The smart contract toolkit for Stacks</td><td><a href="clarinet/overview.md">clarinet/overview.md</a></td></tr></tbody></table>
 
 
 
@@ -107,7 +107,7 @@ We all have different styles of learning. If you've already got a good concept o
 | If you are…                                                                               | First check out...                                                                                                                                                                                                              |
 | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Completely new to building with Stacks                                                    | [Developer Quickstart](get-started/developer-quickstart.md)                                                                                                                                                                     |
-| Learning smart contract development                                                       | [Clarity Crash Course](get-started/clarity-crash-course.md), [Learn Clarinet](/broken/pages/UK5Kgh2MHLoQvfoFVnLr)                                                                                                               |
+| Learning smart contract development                                                       | [Clarity Crash Course](get-started/clarity-crash-course.md), [Learn Clarinet](clarinet/overview.md)                                                                                                               |
 | Preferring a structured, guided course that shows you every step to build full-stack apps | [Stacks Developer Degree](https://learnweb3.io/degrees/stacks-developer-degree/), [Bitcoin Primer](https://app.gitbook.com/s/skGYu79qDNfITOqDNU3s/bitcoin-primer/introduction), [EasyA](https://www.easya.io/challenges/stacks) |
 | Wanting to integrate sBTC in your app                                                     | [sBTC guides](more-guides/sbtc/)                                                                                                                                                                                                |
 | Launching a token                                                                         | [Create Tokens](get-started/create-a-token/)                                                                                                                                                                                    |

docs/build/get-started/path-to-production.md

@@ -39,7 +39,7 @@ To ensure your app or smart contract is production-ready, we pulled together a s
 {% step %}
 ### Specific Clarity/Stacks.js best practices
 
-* [**Post-conditions**](/broken/pages/0KPrPPKItMGZZL2u4tiF): Post conditions are an additional safety feature built into the Stacks chain itself that help to protect end users. Rather than being a function of Clarity smart contracts, they are implemented on the client side and meant to be an additional failsafe against malicious contracts.
+* [**Post-conditions**](../post-conditions/overview.md): Post conditions are an additional safety feature built into the Stacks chain itself that help to protect end users. Rather than being a function of Clarity smart contracts, they are implemented on the client side and meant to be an additional failsafe against malicious contracts.
 * [**Usage of `tx-sender` vs `contract-caller`**](https://www.setzeus.com/public-blog-post/clarity-carefully-tx-sender) : The usage of `tx-sender` versus another Clarity keyword, `contract-caller` , is always a tricky concept because it determines who actually initiated the transaction versus who invoked the current function. Both of them can have certain implications on security based on the context of your code.
 * Write meaningful error codes to improve error handling
 * Adopt a modular contract design approach
@@ -68,7 +68,7 @@ While contracts are immutable once deployed, you can deploy new versions of your
 ### Implement comprehensive testing tools
 
 * [**Unit tests**](../clarinet/testing-with-clarinet-sdk.md)
-* [**Fuzzing**](/broken/pages/h06OJd7RHqUk2Dq7DHwJ)
+* [**Fuzzing**](../rendezvous/overview.md)
 * [**Devnet**](../clarinet/local-blockchain-development.md)
 {% endstep %}
 

docs/build/more-guides/bridging-usdcx.md

@@ -31,7 +31,7 @@
 ### Key Tools To Use
 
 * [viem](https://viem.sh/) - A Typescript-first library that interfaces with Ethereum.
-* [stacks.js](/broken/pages/dH5waQhE6Vb7rhcrUG7z) - A js library that helps developers build Stacks apps by handling transactions, wallet authentication, and smart contract interactions.
+* [Stacks.js](../stacks.js/overview.md) - A JavaScript library that helps developers build Stacks apps by handling transactions, wallet authentication, and smart contract interactions.
 * [Circle Faucet](https://faucet.circle.com/) - Get testnet USDC
 * [Ethereum Sepolia faucet](https://cloud.google.com/application/web3/faucet/ethereum/sepolia) - Get testnet ETH
 * [USDCx API](https://app.gitbook.com/s/GVj1Z9vMuEOMe7oH7Wnq/api/usdcx-bridge) - Fetch deposit and withdrawal status

docs/build/more-guides/sbtc/sbtc-builder-quickstart.md

@@ -22,8 +22,8 @@ In order to get the most from this quickstart, you should familiarize yourself w
 
 * [Stacks Developer Quickstart](https://app.gitbook.com/o/hoh4mQXTl8NvI3cETroY/s/Zz9BLmTU9oydDpL3qiUh/) - For a quick holistic introduction to the Stacks development process, tools, and fundamentals
 * [Clarity Crash Course](../../get-started/clarity-crash-course.md) - For a quick introduction to Clarity
-* [Clarinet Docs](/broken/pages/UK5Kgh2MHLoQvfoFVnLr)
-* [Stacks.js Docs](/broken/pages/dH5waQhE6Vb7rhcrUG7z)
+* [Clarinet Docs](../../clarinet/overview.md)
+* [Stacks.js Docs](../../stacks.js/overview.md)
 
 #### Local with Clarinet
 

docs/press-and-reports/press-and-top-links/2024/README.md

@@ -8,50 +8,50 @@ description: >-
 
 For weekly stories delivered to your inbox, subscribe to [Stacks Snacks](https://stackssnacks.com/). For quarterly ecosystem recaps, subscribe to the [Stacks Foundation newsletter](https://newsletters.stacks.org/).
 
-{% content-ref url="/broken/pages/cd2e8707fe40b8a43e40923a688434e9aaf4922e" %}
-[Broken link](/broken/pages/cd2e8707fe40b8a43e40923a688434e9aaf4922e)
+{% content-ref url="january-2024.md" %}
+[January 2024](january-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/29b9f8cda45db86fe5031ee567341583324e2f6b" %}
-[Broken link](/broken/pages/29b9f8cda45db86fe5031ee567341583324e2f6b)
+{% content-ref url="february-2024.md" %}
+[February 2024](february-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/e7761aa2c81d3c8245dbc54570199f1aebd91325" %}
-[Broken link](/broken/pages/e7761aa2c81d3c8245dbc54570199f1aebd91325)
+{% content-ref url="march-2024.md" %}
+[March 2024](march-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/bbb9712e169fccb44833d8d9f0d98ad2bccd62f2" %}
-[Broken link](/broken/pages/bbb9712e169fccb44833d8d9f0d98ad2bccd62f2)
+{% content-ref url="april-2024.md" %}
+[April 2024](april-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/aec6e9d8a50d144e48a1dfdc8af0e834cd9af457" %}
-[Broken link](/broken/pages/aec6e9d8a50d144e48a1dfdc8af0e834cd9af457)
+{% content-ref url="may-2024.md" %}
+[May 2024](may-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/629cc20de749db943380bddf1d69842a2863033c" %}
-[Broken link](/broken/pages/629cc20de749db943380bddf1d69842a2863033c)
+{% content-ref url="june-2024.md" %}
+[June 2024](june-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/cf07211cab8be8b227dee91931874e3fe5792b8d" %}
-[Broken link](/broken/pages/cf07211cab8be8b227dee91931874e3fe5792b8d)
+{% content-ref url="july-2024.md" %}
+[July 2024](july-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/1fc9a3503ea5c373fb758dc9be7401b5f70501d4" %}
-[Broken link](/broken/pages/1fc9a3503ea5c373fb758dc9be7401b5f70501d4)
+{% content-ref url="august-2024.md" %}
+[August 2024](august-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/db2a454141ac04ca7ea4bc2666e5af5fab4deb68" %}
-[Broken link](/broken/pages/db2a454141ac04ca7ea4bc2666e5af5fab4deb68)
+{% content-ref url="september-2024.md" %}
+[September 2024](september-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/4050fecb50c952b844915fafb1b214eb349e1931" %}
-[Broken link](/broken/pages/4050fecb50c952b844915fafb1b214eb349e1931)
+{% content-ref url="october-2024.md" %}
+[October 2024](october-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/68a55e4003881342d50a527d6f8e683cd5803dde" %}
-[Broken link](/broken/pages/68a55e4003881342d50a527d6f8e683cd5803dde)
+{% content-ref url="november-2024.md" %}
+[November 2024](november-2024.md)
 {% endcontent-ref %}
 
-{% content-ref url="/broken/pages/bd6ef1fe15c0f8e10163ba8857053effe9eb20da" %}
-[Broken link](/broken/pages/bd6ef1fe15c0f8e10163ba8857053effe9eb20da)
+{% content-ref url="december-2024.md" %}
+[December 2024](december-2024.md)
 {% endcontent-ref %}

docs/press-and-reports/press-and-top-links/2025/README.md

@@ -2,4 +2,46 @@
 
 For weekly stories delivered to your inbox, subscribe to [Stacks Snacks](https://stackssnacks.com/). For quarterly ecosystem recaps, subscribe to the [Stacks Foundation newsletter](https://newsletters.stacks.org/).
 
-<table data-view="cards"><thead><tr><th>Issue</th><th data-card-target data-type="content-ref">Target</th></tr></thead><tbody><tr><td>january-2024.md</td><td><a href="/broken/pages/3397988268e7e9cfe7865579259cc3cb68109fe4">Broken link</a></td></tr><tr><td>february-2025.md</td><td><a href="/broken/pages/d25fa9955b22a0dbc03fbd451d72c87b06cc857c">Broken link</a></td></tr><tr><td>march-2025.md</td><td><a href="/broken/pages/ca615f65ea8a50d1ae03f9fb13b41bb10bb5e12e">Broken link</a></td></tr><tr><td>march-2025-1.md</td><td><a href="/broken/pages/b93ec446bef158c77fb12bfc5dba6d6b409c74d4">Broken link</a></td></tr><tr><td>march-2025-2.md</td><td><a href="/broken/pages/b7c1145a395e6afe0380520317322eba7ae6dd22">Broken link</a></td></tr><tr><td>june-2025.md</td><td><a href="/broken/pages/7627ee2dcff8e9ea989b8640a271bc2ee0ac88cf">Broken link</a></td></tr><tr><td>june-2025-1.md</td><td><a href="/broken/pages/7cdb783024b45ee18da6c1fb81cb0e7eea02985d">Broken link</a></td></tr><tr><td>june-2025-2.md</td><td><a href="/broken/pages/e2cd511cd9d9c32b0830c6b57b4d27a5fe46c5d7">Broken link</a></td></tr><tr><td>june-2025-2-1.md</td><td><a href="/broken/pages/c8792a3555695035ab578c03c8829f1b9d54c7d5">Broken link</a></td></tr></tbody></table>
+{% content-ref url="january-2025.md" %}
+[January 2025](january-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="february-2025.md" %}
+[February 2025](february-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="march-2025.md" %}
+[March 2025](march-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="april-2025.md" %}
+[April 2025](april-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="may-2025.md" %}
+[May 2025](may-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="june-2025.md" %}
+[June 2025](june-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="july-2025.md" %}
+[July 2025](july-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="august-2025.md" %}
+[August 2025](august-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="september-2025.md" %}
+[September 2025](september-2025.md)
+{% endcontent-ref %}
+
+{% content-ref url="september-2025-1.md" %}
+[September 2025 Update 1](september-2025-1.md)
+{% endcontent-ref %}
+
+{% content-ref url="september-2025-2.md" %}
+[September 2025 Update 2](september-2025-2.md)
+{% endcontent-ref %}

docs/reference/README.md

@@ -10,4 +10,4 @@ If you’re an experienced Stacks developer looking to quickly reference a speci
 
 ### Looking for references on...
 
-<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>APIs</h4></td><td>Endpoints for interacting with Stacks nodes, signers, sBTC bridge, and the USDCx bridge</td><td><a href="/broken/pages/VE4heUS6HL5ewDIsTB7y">Broken link</a></td></tr><tr><td><h4>Clarity</h4></td><td>Definitions for types, functions, and keywords</td><td><a href="/broken/pages/x7RDdoQrfnkI7FC2qAgp">Broken link</a></td></tr><tr><td><h4>Clarinet</h4></td><td>CLI commands for developing and deploying contracts</td><td><a href="/broken/pages/vU44OYsBZfmCiz5Lh1Kt">Broken link</a></td></tr><tr><td><h4>Clarinet JS SDK</h4></td><td>Test and simulate contracts in JavaScript</td><td><a href="/broken/pages/6UWm1kHMTtaK413v62ZN">Broken link</a></td></tr><tr><td><h4>Rendezvous</h4></td><td>Property-based testing and fuzzing for Clarity</td><td><a href="/broken/pages/dxhRl574FN3VvBd9YzHk">Broken link</a></td></tr><tr><td><h4>Stacks.js</h4></td><td>Definitions for functions and types when building frontend/backend scripts</td><td><a href="/broken/pages/5uVTuhiSh8LW8ljzHnIC">Broken link</a></td></tr></tbody></table>
+<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>APIs</h4></td><td>Endpoints for interacting with Stacks nodes, signers, sBTC bridge, and the USDCx bridge</td><td><a href="api/stacks-blockchain-api/README.md">api/stacks-blockchain-api/README.md</a></td></tr><tr><td><h4>Clarity</h4></td><td>Definitions for types, functions, and keywords</td><td><a href="clarity/functions.md">clarity/functions.md</a></td></tr><tr><td><h4>Clarinet</h4></td><td>CLI commands for developing and deploying contracts</td><td><a href="clarinet/cli-reference.md">clarinet/cli-reference.md</a></td></tr><tr><td><h4>Clarinet JS SDK</h4></td><td>Test and simulate contracts in JavaScript</td><td><a href="clarinet-js-sdk/sdk-reference.md">clarinet-js-sdk/sdk-reference.md</a></td></tr><tr><td><h4>Rendezvous</h4></td><td>Property-based testing and fuzzing for Clarity</td><td><a href="rendezvous/reference.md">rendezvous/reference.md</a></td></tr><tr><td><h4>Stacks.js</h4></td><td>Definitions for functions and types when building frontend/backend scripts</td><td><a href="stacks.js/stacks-wallet/README.md">stacks.js/stacks-wallet/README.md</a></td></tr></tbody></table>

docs/reference/nakamoto-upgrade/nakamoto-rollout-plan/nakamoto-for-exchanges.md

@@ -6,7 +6,7 @@
 
 The Nakamoto release brings many new capabilities and improvements to the Stacks blockchain by focusing on a set of core advancements: improving transaction speed, enhancing finality guarantees for transactions, mitigating Bitcoin miner MEV (miner extractable value) opportunities that affect PoX, and boosting robustness against chain reorganizations. This strategic upgrade aims to solidify trust in the Stacks network, offer greater alignment with Bitcoin's immutable nature, and foster an environment ripe for advanced Decentralized Finance (DeFi) applications. The expected outcome is a versatile, scalable, and secure platform that closely integrates with, yet distinctly enhances, the Bitcoin ecosystem.
 
-Learn more: [Broken link](/broken/pages/fac008cad2409afc8de86501f205ee51e148b5af "mention")
+Learn more: [What is the Nakamoto Release?](../what-is-the-nakamoto-release.md)
 
 </details>
 
@@ -27,7 +27,7 @@ The main thing exchanges will notice when the Nakamoto rollout is complete is th
 ### Resources
 
 * [Testnet documentation](https://docs.stacks.co/nakamoto-upgrade/nakamoto)
-* [API documentation](https://docs.hiro.so/nakamoto/stacks-js)
+* [API documentation](../../api/stacks-mesh-api/README.md)
 * [Stacks Core Binaries](https://github.com/stacks-network/stacks-core/releases/latest)
 * [Stacks Signer Binary](https://github.com/stacks-network/stacks-core/releases/tag/signer-3.1.0.0.5.0)
 * [Stacks Core Docker Images](https://hub.docker.com/r/blockstack/stacks-core/tags?page=1\&name=3.1.0.0.5)