Merge pull request 'docs: show {internet,tor} in docs; with experimental notice' (#5557) from fix-deletions into main

Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/5557

clanServices/internet/README.md

@@ -1,3 +1,11 @@
+🚧🚧🚧 Experimental 🚧🚧🚧
+
+Use at your own risk.
+
+We are still refining its interfaces, instability and breakages are expected.
+
+---
+
 This module is part of Clan's [networking interface](https://docs.clan.lol/guides/networking/networking/).
 
 Clan's networking module automatically manages connections across available network transports and falls back intelligently. When you run `clan ssh` or `clan machines update`, Clan attempts each configured network in priority order until a connection succeeds.
@@ -16,4 +24,4 @@ The example below shows how to configure a domain so server1 is reachable over t
             };
         };
 };
-```
+```

clanServices/internet/default.nix

@@ -8,7 +8,6 @@
     "Network"
   ];
   manifest.readme = builtins.readFile ./README.md;
-
   roles.default = {
     description = "Placeholder role to apply the internet service";
     interface =

clanServices/tor/README.md

@@ -1,3 +1,11 @@
+🚧🚧🚧 Experimental 🚧🚧🚧
+
+Use at your own risk.
+
+We are still refining its interfaces, instability and breakages are expected.
+
+---
+
 This module is part of Clan's [networking interface](https://docs.clan.lol/guides/networking/networking/).
 
 Clan's networking module automatically manages connections across available network transports and falls back intelligently. When you run `clan ssh` or `clan machines update`, Clan attempts each configured network in priority order until a connection succeeds.
@@ -11,4 +19,4 @@ The example below configures all your nixos machines to be reachable over the To
             roles.server.tags.nixos = { };
         };
 };
-```
+```

docs/mkdocs.yml

@@ -164,6 +164,7 @@ nav:
           - services/official/emergency-access.md
           - services/official/garage.md
           - services/official/hello-world.md
+          - services/official/internet.md
           - services/official/importer.md
           - services/official/kde.md
           - services/official/localbackup.md
@@ -174,6 +175,7 @@ nav:
           - services/official/sshd.md
           - services/official/syncthing.md
           - services/official/trusted-nix-caches.md
+          - services/official/tor.md
           - services/official/users.md
           - services/official/wifi.md
           - services/official/wireguard.md

pkgs/docs-from-code/generate/__init__.py

@@ -313,10 +313,6 @@ def produce_clan_service_docs() -> None:
         service_links: dict[str, dict[str, dict[str, Any]]] = json.load(f3)
 
     for module_name, module_info in service_links.items():
-        # Skip specific modules that are not ready for documentation
-        if module_name in ["internet", "tor"]:
-            continue
-
         output = f"# {module_name}\n\n"
         # output += f"`clan.modules.{module_name}`\n"
         output += f"*{module_info['manifest']['description']}*\n"