diff --git a/docs/user-guide/offline.md b/docs/user-guide/offline.md
index fce68c5..9bf7717 100644
--- a/docs/user-guide/offline.md
+++ b/docs/user-guide/offline.md
@@ -38,7 +38,7 @@ cd pyscript-offline
 ### PyScipt core from source
 
 Build PyScript core by cloning the project repository and follow the
-instructions in our [developer guide](/developers)
+instructions in our [developer guide](../developers.md)
 
 Once completed, copy the `build` folder, that was been created by the build
 step, into your `pyscript-offline` folder.
diff --git a/docs/user-guide/workers.md b/docs/user-guide/workers.md
index 2e54c68..270116f 100644
--- a/docs/user-guide/workers.md
+++ b/docs/user-guide/workers.md
@@ -8,7 +8,7 @@ Happily, PyScript makes it very easy to use workers and uses a feature recently
 added to web standards called
 [Atomics](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics).
 You don't need to know about Atomics to use web workers, but the underlying
-[coincident library](http://localhost:8000/user-guide/architecture/#coincident)
+[coincident library](architecture.md#coincident)
 uses it under the hood.
 
 !!! info