diff --git a/docs/components/ALKiln/components/_need_proxy_vars.md b/docs/components/ALKiln/components/_need_proxy_vars.md
index 1ee511090..af1174c66 100644
--- a/docs/components/ALKiln/components/_need_proxy_vars.md
+++ b/docs/components/ALKiln/components/_need_proxy_vars.md
@@ -1,3 +1,3 @@
-If your interview uses [generic objects](https://docassemble.org/docs/fields.html#generic) (`x`) or [index variables](https://docassemble.org/docs/fields.html#index%20variables) (`i`, `j`, `k`, etc), you **must** have [special HTML](../writing_tests.mdx#special-html) in your interview to set the values of variables.
+If your interview uses [generic objects](https://docassemble.org/docs/fields.html#generic) (`x`) or [index variables](https://docassemble.org/docs/fields.html#index%20variables) (`i`, `j`, `k`, etc), you **must** have [special HTML](writing#special-html) in your interview to set the values of variables.
 
 <!-- TODO: help wanted: This is true as long as they don't literally use `x` or `i`. I'm not sure how to express that complexity. -->
\ No newline at end of file
diff --git a/docs/components/ALKiln/components/_scenario_folder_contents.js b/docs/components/ALKiln/components/_scenario_folder_contents.js
index e1cff235e..c2df4f112 100644
--- a/docs/components/ALKiln/components/_scenario_folder_contents.js
+++ b/docs/components/ALKiln/components/_scenario_folder_contents.js
@@ -6,22 +6,22 @@ export const ScenarioDir = () => {
   return (
     <ul>
       <li>
-        An individual <Link to="writing_tests.mdx#report">report.txt</Link>
+        An individual <Link to="writing#report">report.txt</Link>
       </li>
       <li>
-        Another copy of <Link to="writing_tests.mdx#error-pics">error screenshots and html files</Link>
+        Another copy of <Link to="writing#error-pics">error screenshots and html files</Link>
       </li>
       <li>
-        <Link to="writing_tests.mdx#pic">Pictures you took of screens along with their associated HTML files</Link>
+        <Link to="writing#pic">Pictures you took of screens along with their associated HTML files</Link>
       </li>
       <li>
-        <Link to="writing_tests.mdx#download">Files you downloaded</Link>
+        <Link to="writing#download">Files you downloaded</Link>
       </li>
       <li>
-        <Link to="writing_tests.mdx#compare-json">JSON variables you compared</Link>
+        <Link to="writing#compare-json">JSON variables you compared</Link>
       </li>
       <li>
-        <Link to="writing_tests.mdx#a11y-all">Accessibility failures</Link>
+        <Link to="writing#a11y-all">Accessibility failures</Link>
       </li>
     </ul>
   );
diff --git a/docs/components/ALKiln/components/_secure_env_vars.md b/docs/components/ALKiln/components/_secure_env_vars.md
index 57a24d023..ba2ad99a8 100644
--- a/docs/components/ALKiln/components/_secure_env_vars.md
+++ b/docs/components/ALKiln/components/_secure_env_vars.md
@@ -1,4 +1,4 @@
-Since [workflow environment variables](../writing_tests.mdx#env-vars) might hold sensitive information, ALKiln avoids taking pictures or downloading the HTML of pages that use environment variables, even when the test has an error on that page. ALKiln avoids printing the value of an environment variable anywhere in the [report](../writing_tests.mdx#reports) or in the [console log](../writing_tests.mdx#console).
+Since [workflow environment variables](writing#env-vars) might hold sensitive information, ALKiln avoids taking pictures or downloading the HTML of pages that use environment variables, even when the test has an error on that page. ALKiln avoids printing the value of an environment variable anywhere in the [report](writing#reports) or in the [console log](writing#console).
 
 <!--
 TODO: ALKiln:
diff --git a/docs/components/ALKiln/components/_test_types.js b/docs/components/ALKiln/components/_test_types.js
index 5bdef16d0..47c799d7f 100644
--- a/docs/components/ALKiln/components/_test_types.js
+++ b/docs/components/ALKiln/components/_test_types.js
@@ -6,7 +6,7 @@ export const GTOYS = (props) => {
   if ( props.plain === true ) {
     return <span>GitHub+You™</span>
   } else {
-    return <Link to="setup.mdx#githubNyou-details">GitHub+You™</Link>
+    return <Link to="setup#githubNyou-details">GitHub+You™</Link>
   }
 }
 
@@ -15,7 +15,7 @@ export const AutoDIY = (props) => {
   if ( props.plain === true ) {
     return <span>ALKilnInThePlayground™</span>
   } else {
-    return <Link to="setup.mdx#diy-details">ALKilnInThePlayground™</Link>
+    return <Link to="setup#diy-details">ALKilnInThePlayground™</Link>
   }
 }
 
@@ -24,6 +24,6 @@ export const KittyLitter = (props) => {
   if ( props.plain === true ) {
     return <span>GitHub Sandbox™</span>
   } else {
-    return <Link to="setup.mdx#sandbox-details">GitHub Sandbox™</Link>
+    return <Link to="setup#sandbox-details">GitHub Sandbox™</Link>
   }
 }
diff --git a/docs/components/ALKiln/components/_with_secrets.md b/docs/components/ALKiln/components/_with_secrets.md
index 25c1df7bb..8de0061cb 100644
--- a/docs/components/ALKiln/components/_with_secrets.md
+++ b/docs/components/ALKiln/components/_with_secrets.md
@@ -1 +1 @@
-If you have an organization and want to use these values in multiple repositories, you can use [organization GitHub secrets](../writing_tests.mdx#org-secrets). In that case, your workflow file code would look more like this:
\ No newline at end of file
+If you have an organization and want to use these values in multiple repositories, you can use [organization GitHub secrets](writing#org-secrets). In that case, your workflow file code would look more like this:
\ No newline at end of file
diff --git a/docs/components/ALKiln/writing_tests.mdx b/docs/components/ALKiln/writing_tests.mdx
index bbc13e837..b98a11c99 100644
--- a/docs/components/ALKiln/writing_tests.mdx
+++ b/docs/components/ALKiln/writing_tests.mdx
@@ -35,7 +35,7 @@ If you are writing tests <!-- , running tests, --> or need to learn about test f
 
 If you are coming back and just need some resource reminders, here is a short list:
 
-- You can see [what your first test might look like](alkiln_setup#first-test).
+- You can see [what your first test might look like](setup.mdx#first-test).
 - You can generate a first draft for a more complex test with the help of the [ALKiln Story Table Step generator](#alkiln_story).
 - If your interview is using generic objects or index variables, you **must** include [special HTML](#special-html) in your interview.
 - Every time you change or add a required field variable, you must update the tests that need that variable.
@@ -2537,7 +2537,7 @@ If your package is leaving out the al_package.yml file from the Assembly Line pa
 
 ### Testing unfinished code {#unstable-tip}
 
-If you are still developing your interview, you can still write a [simple test](alkiln_setup#first-test) to make sure your interview at least loads without an error. You might want to wait till your code is more stable to write more tests.
+If you are still developing your interview, you can still write a [simple test](setup.mdx#first-test) to make sure your interview at least loads without an error. You might want to wait till your code is more stable to write more tests.
 
 On the other hand, if there is a part of your interview that you think will stay pretty much the same, you can write tests that just go part-way through the interview to test just the stable part of the code. That way, you can work on adding more content and yet also be sure that the work you've already done stays working.