Update how links are resolved

Author: AndreasArvidsson

packages/cursorless-org-docs/docusaurus.config.mts

@@ -9,6 +9,10 @@ import { fileURLToPath } from "node:url";
 
 const require = createRequire(import.meta.url);
 
+const userRelative = "packages/cursorless-org-docs/src/docs/user";
+const contributingRelative =
+  "packages/cursorless-org-docs/src/docs/contributing";
+
 /**
  * Files within /docs reference repository directories
  * and files outside of that folder. They are not served
@@ -41,12 +45,19 @@ function remarkPluginFixLinksToRepositoryArtifacts(): Transformer<Root> {
         dirname(fileURLToPath(import.meta.url)),
         "../..",
       );
+
       const artifact = resolve(file.dirname!, url);
       const artifactRelative = relative(repoRoot, artifact).replace(/\\/g, "/");
+      const fileRelative = relative(repoRoot, file.path).replace(/\\/g, "/");
 
-      // We host all files under docs, will resolve as a relative link
+      // We host all files under docs, will resolve as a relative link, but
+      // relative links passing between user and contributing are not resolved
+      // correctly
       if (
-        artifactRelative.startsWith("packages/cursorless-org-docs/src/docs/")
+        (artifactRelative.startsWith(userRelative) &&
+          fileRelative.startsWith(userRelative)) ||
+        (artifactRelative.startsWith(contributingRelative) &&
+          fileRelative.startsWith(contributingRelative))
       ) {
         return;
       }

packages/cursorless-org-docs/src/docs/contributing/adding-a-new-language.md

@@ -41,7 +41,7 @@ Follow the instructions in [Adding a new scope](./adding-a-new-scope.md) to defi
 
 ## 5. Document your language
 
-Create a `.mdx` file in [`languages`](../../user/languages) with the `Language` react component. The file should be named after your language, eg `java.mdx`
+Create a `.mdx` file in [`languages`](../user/languages) with the `Language` react component. The file should be named after your language, eg `java.mdx`
 
 ```md
 import { Language } from "./components/Language";

packages/cursorless-org-docs/src/docs/contributing/architecture/neovim-test-infrastructure.md

@@ -300,7 +300,7 @@ cursorless.nvim/.busted
 ### Running lua unit tests
 
 Many of the cursorless.nvim lua functions are run in order to complete Cursorless actions and so are already
-indirectly tested by the tests described in the [previous section](#3-cursorless-tests-for-neovim). Nevertheless, we run
+indirectly tested by the tests described in the [previous section](#running-neovim-tests-locally). Nevertheless, we run
 more specific unit tests in order to give better visibility into exactly which functions are failing.
 The [busted](https://github.com/lunarmodules/busted) framework is used to test lua functions defined in cursorless.nvim.
 This relies on a `cursorless.nvim/.busted` file which directs busted to use a lua interpreter and test specifications files: