docs: unify markdown files with documentation titles

This is preparational work to reduce the surface are of the different mappings

We want to reduce the following:

/guides/secrets.md -> Guides/getting started/How to use flakes with sops -> with '# Secrets Management'

- Title
- URI
- Filepath

should follow a stricter pattern to make it easy to maintain

pkgs/clan-cli/clan_cli/hyperlink.py

@@ -32,7 +32,7 @@ def help_hyperlink(description: str, url: str) -> str:
 
 def docs_hyperlink(description: str, url: str) -> str:
     """Returns a markdown hyperlink"""
-    url = url.replace("https://docs.clan.lol", "../..")
+    url = url.replace("https://docs.clan.lol", "/")
     url = url.replace("index.html", "index")
     url += ".md"
     return f"[{description}]({url})"