fix hrefs in markdown and add testing and CI failures

Author: jderochervlk

markdown-pages/blog/archived/state-of-reasonml-org-2020-q2-pt1.mdx

@@ -65,7 +65,7 @@ We also focused a lot on early feedback from the community, so we regularly [pos
 
 The current [official BuckleScript's API docs](https://bucklescript.github.io/bucklescript/api/index_modules.html) aren't visually stunning, but they _are_ important for getting things done as a user. The docs are maintained within the BuckleScript repository, and there was no process to make sure the documentation site remained up to date with each BuckleScript release. It also presented a huge bottleneck for anyone hoping to contribute from the outside. So [Nik Graf](https://twitter.com/nikgraf) bit the bullet, did the massive amount of grunt work to extract all the available modules and function headers into hand curated markdown files, and organize them into easily-maintained documents from a technical writer's perspective.
 
-So we now have most of BuckleScript v7's [JS / Belt module](https://rescript-lang.org/docs/manual/api/latest/belt) documented.
+So we now have most of BuckleScript v7's [JS / Belt module](/docs/manual/api/belt) documented.
 
 We are now working on further automating the process for generating BuckleScript documentation by adding JSON export functionality to `odoc`. As soon as this is done, we will upstream our latest hand curated changes to the BuckleScript inline documentation and also give better guidance on contributing to the JS / Belt documentation in the source code as well.
 

markdown-pages/blog/enhanced-ergonomics-for-record-types.mdx

@@ -7,16 +7,16 @@ description: |
   A tour of new capabilities coming to ReScript v11
 ---
 
-> This is the second post covering new capabilities that'll ship in ReScript v11. You can check out the first post on [better interop with customizable variants here](https://rescript-lang.org/blog/improving-interop).
+> This is the second post covering new capabilities that'll ship in ReScript v11. You can check out the first post on [better interop with customizable variants here](./improving-interop.mdx).
 
-[Records](https://rescript-lang.org/docs/manual/record) are a fundamental part of ReScript, offering a clear and concise definition of complex data structures, immutability by default, great error messages, and support for exhaustive pattern matching.
+[Records](../docs/manual/record.mdx) are a fundamental part of ReScript, offering a clear and concise definition of complex data structures, immutability by default, great error messages, and support for exhaustive pattern matching.
 
 Even though records are generally preferable for defining structured data, there are still a few ergonomic annoyances, such as...
 
 1. Existing record types can't be extended, which makes them hard to compose
 2. Functions may only accept record arguments of the exact record type (no explicit sub-typing)
 
-To mitigate the limitations above, one would need to retreat to [structural objects](https://rescript-lang.org/docs/manual/object#sidebar) to allow more flexible object field sharing and sub-typing, at the cost of more complex type errors and no pattern matching capabilities.
+To mitigate the limitations above, one would need to retreat to [structural objects](../docs/manual/object.mdx#sidebar) to allow more flexible object field sharing and sub-typing, at the cost of more complex type errors and no pattern matching capabilities.
 
 We think that records are a much more powerful data structure though, so we want to encourage more record type usage for these scenarios. This is why ReScript v11 will come with two new big enhancements for record types: **Record Type Spread** and **Record Type Coercion**.
 
@@ -175,7 +175,7 @@ Records are nominally typed, so it is not possible to pass a record `a` as recor
 
 ## Try it out!
 
-Feel free to check out the v11 alpha version on our [online playground](https://rescript-lang.org/try?version=v11.0.0-alpha.5&code=LYewJgrgNgpgBAJRgYxAJzAFQJ4AcYDKuaMAhmAKIAepwuscAvHAN4BQccALnvKU6w6c4AO1owAXHADOXNAEsRAcwA0QzqSWS4irms4BfNkJ744AIwHtho8VNkLl+4Zu27nRobC63gMAGJoIMAAQgIAFOZS5gCUTAB8FgB0Yn7GnN5wpFL8zNbCqdoARABy4kXOGlpSAMwArB7pcJmFAoWBwSHh4fwSibExbJ6gkAxIqBg4+ADCIDBoyPIgItS09PB5JrxZVuo6YPZyiqp7hYeOJzauUu57pMhc8gBu2uYgIFCNW2aWmzZnMiOTju1R0Ij0Qk8GRgPnaQVCESiFjijH6KXETUy2R2f2E8gOcCKAEYKqc7ISyn5SVdQfVKlkHs9tHIIDAvtDYeI2uIOqFur1+jFBkYgA), or install the alpha release via npm: `npm i rescript@11.0.0-alpha.6`.
+Feel free to check out the v11 alpha version on our [online playground](/try?version=v11.0.0-alpha.5&code=LYewJgrgNgpgBAJRgYxAJzAFQJ4AcYDKuaMAhmAKIAepwuscAvHAN4BQccALnvKU6w6c4AO1owAXHADOXNAEsRAcwA0QzqSWS4irms4BfNkJ744AIwHtho8VNkLl+4Zu27nRobC63gMAGJoIMAAQgIAFOZS5gCUTAB8FgB0Yn7GnN5wpFL8zNbCqdoARABy4kXOGlpSAMwArB7pcJmFAoWBwSHh4fwSibExbJ6gkAxIqBg4+ADCIDBoyPIgItS09PB5JrxZVuo6YPZyiqp7hYeOJzauUu57pMhc8gBu2uYgIFCNW2aWmzZnMiOTju1R0Ij0Qk8GRgPnaQVCESiFjijH6KXETUy2R2f2E8gOcCKAEYKqc7ISyn5SVdQfVKlkHs9tHIIDAvtDYeI2uIOqFur1+jFBkYgA), or install the alpha release via npm: `npm i rescript@11.0.0-alpha.6`.
 
 This release is mainly for feedback purposes and not intended for production usage.
 

markdown-pages/blog/improving-interop.mdx

@@ -225,7 +225,7 @@ We can now utilize pattern matching fully without needing to do any conversion.
 This has a few implications:
 
 - Dealing with external data, that is often nullable and seldom guaranteed to map cleanly to `option` without needing conversion, becomes much easier and zero cost.
-- Special handling like [@return(nullable)](https://rescript-lang.org/syntax-lookup/return-decorator) becomes redundant. This is good also because the current functionality does not work in all cases. The new functionality will work anywhere.
+- Special handling like [@return(nullable)](../syntax-lookup/decorator_return.mdx) becomes redundant. This is good also because the current functionality does not work in all cases. The new functionality will work anywhere.
 
 ### Decoding and encoding JSON idiomatically
 

markdown-pages/blog/introducing-unified-operators.mdx

@@ -19,7 +19,7 @@ let addFloat = 1.0 + 2.0
 let concatString = "Hello" + ", World!"
 ```
 
-[Try in the playground](https://rescript-lang.org/try?version=v12.0.0-alpha.5&module=esmodule&code=DYUwLgBAhgJjCSA7SBeCBGCBqCAmAUKJLDAGLAD2UqGAdAAzZ4OHgQDGFi71AymACcAlogDmENACIAEiGCVJTSQBoIAdQoDgMAIST8QA)— it just works since `v12.0.0-alpha.5`. We don't need `+.` and `++` anymore. 🥳
+[Try in the playground](/try?version=v12.0.0-alpha.5&module=esmodule&code=DYUwLgBAhgJjCSA7SBeCBGCBqCAmAUKJLDAGLAD2UqGAdAAzZ4OHgQDGFi71AymACcAlogDmENACIAEiGCVJTSQBoIAdQoDgMAIST8QA)— it just works since `v12.0.0-alpha.5`. We don't need `+.` and `++` anymore. 🥳
 
 This post covers both the reasoning behind the change and what’s next on the roadmap. If you're interested in the implementation details, you’ll find them in [the pull request](https://github.com/rescript-lang/rescript/pull/7057).
 

markdown-pages/blog/new-rescript-logo.mdx

@@ -56,7 +56,7 @@ We'd like to position ReScript to be a community of product-first developers who
 
 ## Next Steps
 
-In the next few weeks, we will gradually roll out our new brand identity across our official communication platforms. We'll also provide marketing material and assets on our [brand assets page](https://rescript-lang.org/brand) for our users.
+In the next few weeks, we will gradually roll out our new brand identity across our official communication platforms. We'll also provide marketing material and assets on our [brand assets page](/brand) for our users.
 
 We hope you enjoyed our new design article. In the future, we're hoping to interleave our technical releases with a few design and UX-oriented posts. Stay tuned!
 

markdown-pages/blog/release-10-1.mdx

@@ -82,7 +82,7 @@ ReScript 10.1 now ships with JSX v4. Here's what's new:
 - **Two new transformation modes**. JSX v4 comes with a `classic` mode (= `React.createElement`) and `automatic` mode (= `jsx-runtime` calls). The latter is the new default, moving forward with `rescript/react@0.11` and `React@18`.
 - **Allow mixing JSX configurations on the project and module level.** Gradually mix and match JSX transformations and modes without migrating any old code!
 - **Pass `prop` types** to `@react.component`. You can now fine tune `@react.component` with your specific prop type needs. Very useful for libraries and frameworks to define component interfaces.
-Less boilerplate when using `React.Context`.
+  Less boilerplate when using `React.Context`.
 - **Revisited props spread operator.** This will allow users to spread records in JSX without sacrificing their sanity. Note that this implementation has harder constraints than its JS counterpart. (requires `rescript/react@0.11` or higher)
 - **Better type inference of props.** Type inference when passing e.g. variants that are defined in the same module as the component is much improved. With the earlier JSX version, you'd often need to write code like this in order for the compiler to understand which variant you're passing: `<Button variant=Button.Primary text="Click" />`. With JSX v4, you won't need to tell the compiler where the variant you're passing is located: `<Button variant=Primary text="Click" />`.
 

markdown-pages/blog/release-11-0-0.mdx

@@ -52,7 +52,7 @@ This release is also introducing uncurried mode, which is a new default mode tha
 
 [ReScript Core](https://github.com/rescript-lang/rescript-core) is ReScript's new standard library. It replaces the complete `Js` module as well as some of the more frequently used modules from `Belt` and is recommended to use with uncurried mode.
 
-The latest docs on [rescript-lang.org](/) already use it for the examples. Have a look at the new [RescriptCore API docs](https://rescript-lang.org/docs/manual/api/latest/stdlib).
+The latest docs on [rescript-lang.org](/) already use it for the examples. Have a look at the new [RescriptCore API docs](/docs/manual/api/stdlib).
 
 ## More Features
 

markdown-pages/blog/release-11-1-0.mdx

@@ -130,7 +130,7 @@ var p = 2n ** 2n;
 
 </CodeTab>
 
-See [big integer docs](https://rescript-lang.org/docs/manual/primitive-types#big-integers-experimental) for more.
+See [big integer docs](../docs/manual/primitive-types.mdx#big-integers-experimental) for more.
 
 ## Array spread syntax
 

markdown-pages/blog/release-8-3-2.mdx

@@ -64,7 +64,7 @@ so that the second build will do the rebuild.
 The benefit is two fold:
 
 - Rebuild will re-capture those warnings
-- Rebuild will be fast since only those files with warnings get rebuilt, it will not trigger unnecessary builds since our build is [content-based](https://rescript-lang.org/blog/scalable) build system.
+- Rebuild will be fast since only those files with warnings get rebuilt, it will not trigger unnecessary builds since our build is content-based build system.
 
 The integration between compiler and build system is encoded in a specialized protocol. This makes it almost cost-free.
 

markdown-pages/blog/release-9-0.mdx

@@ -20,7 +20,7 @@ Use `npm` to install the newest [9.0.1 release](https://www.npmjs.com/package/bs
 npm install bs-platform@9.0.1
 ```
 
-You can also try our new release in the [Online Playground](https://rescript-lang.org/try).
+You can also try our new release in the [Online Playground](/try).
 
 In this post we will highlight the most notable changes. The full changelog for this release can be found [here](https://github.com/rescript-lang/rescript/blob/master/Changes.md#90).