diff --git a/docs/apps/quickstart.md b/docs/apps/quickstart.md
index fdcaef56..f0caa433 100644
--- a/docs/apps/quickstart.md
+++ b/docs/apps/quickstart.md
@@ -49,6 +49,6 @@ TODO: tfrpc
 
 Apps can interact with Tilde Friends using tfrpc.
 
-Read <tfrpc.md>
+Read [tfrpc.md](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/apps/tfrpc.md)
 
 TODO: sharing apps
diff --git a/docs/building.md b/docs/building.md
index da7727a1..c00cc21d 100644
--- a/docs/building.md
+++ b/docs/building.md
@@ -41,7 +41,7 @@ To build in docker, `docker build .`
 <!-- On NixOS: TODO -->
 <!-- Add shell.nix and nix derivs first -->
 
-Now that you have a binary, head over to <running.md>.
+Now that you have a binary, head over to [running.md](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/running.md).
 
 ## Troubleshooting
 
diff --git a/docs/contributing.md b/docs/contributing.md
index d48b67ee..021e4ed9 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -38,7 +38,7 @@ TODO
 
   - I want to write documentation !
 
-    Great! Before you do, have a look at the [documentation guidelines](guidelines/documentation-guidelines.md) to learn how to write consistent documentation.
+    Great! Before you do, have a look at the [documentation guidelines](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/guidelines/documentation-guidelines.md) to learn how to write consistent documentation.
 
     In all cases:
 
diff --git a/docs/documentation.md b/docs/documentation.md
index 2907d247..174fa09c 100644
--- a/docs/documentation.md
+++ b/docs/documentation.md
@@ -2,12 +2,12 @@
 
 ## Building
 
-See <building.md>.
+See [building.md](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/building.md).
 
 ## Contibuting
 
-See <contributing.md>.
+See [contributing.md](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/contributing.md).
 
 ## FAQ / Troubleshooting
 
-See <faq.md>.
+See [faq.md](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/faq.md).
diff --git a/docs/faq.md b/docs/faq.md
index c8e6f4fc..ca5d5ea5 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -2,11 +2,11 @@
 
 ## I started tildefriends. Now what ?
 
-See <running.md>.
+See [running.md](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/running.md).
 
 ### The compiler throws an error and I can't build the binary
 
-See <building.md>.
+See [building.md](https://dev.tildefriends.net/cory/tildefriends/src/branch/main/docs/building.md).
 
 ### Where is my database located ?