docs: move services into its reserved category

docs/mkdocs.yml

@@ -63,8 +63,8 @@ nav:
       - Inventory:
           - Introduction to Inventory: guides/inventory/inventory.md
           - File Autoincludes: guides/inventory/autoincludes.md
-      - Clan Services:
+      - Services:
-          - Inventory Guide: guides/inventory/clanServices.md
+          - Introduction to Services: guides/services/introduction-to-services.md
           - Author Your Own Service: guides/services/community.md
       - Vars:
           - Introduction to Vars: guides/vars/vars-overview.md

docs/site/getting-started/add-services.md

@@ -8,7 +8,7 @@ In Clan Services are multi-Host & role-based:
 
 - You can use tags instead of explicit machine names.
 
-To learn more: [Guide about clanService](../guides/inventory/clanServices.md)
+To learn more: [Guide about clanService](../guides/services/introduction-to-services.md)
 
 !!! Important
     It is recommended to add at least one networking service such as `zerotier` that allows to reach all your clan machines from your setup computer across the globe.
@@ -38,8 +38,8 @@ To learn more: [Guide about clanService](../guides/inventory/clanServices.md)
 }
 ```
 
-1. See [reference/clanServices](../services/official/index.md) for all available services and how to configure them.
+1. See [services/official](../services/official/index.md) for all available services and how to configure them.
-   Or read [authoring/clanServices](../guides/services/community.md) if you want to bring your own
+   Or read [guides/services](../guides/services/community.md) if you want to bring your own
 
 2. Replace `__YOUR_CONTROLLER_` with the *name* of your machine.
 

docs/site/guides/migrations/migrate-inventory-services.md

@@ -380,4 +380,4 @@ instances = {
 
 * [Inventory Concept](../../guides/inventory/inventory.md)
 * [Authoring a 'clan.service' module](../../guides/services/community.md)
-* [ClanServices](../../guides/inventory/clanServices.md)
+* [ClanServices](../../guides/services/introduction-to-services.md)

docs/site/guides/services/introduction-to-services.md

@@ -1,11 +1,11 @@
-Clan's inventory system is a composable way to define and deploy services across
+Clan's services are a modular way to define and deploy services across
 machines.
 
-This guide shows how to **instantiate** a `clanService`, explains how service
+This guide shows how to **instantiate** a **service**, explains how service
-definitions are structured in your inventory, and how to pick or create services
+definitions are structured and how to pick or create services
 from modules exposed by flakes.
 
-The term **Multi-host-modules** was introduced previously in the [nixus
+A similar term: **Multi-host-modules** was introduced previously in the [nixus
 repository](https://github.com/infinisil/nixus) and represents a similar
 concept.
 

docs/site/index.md

@@ -74,11 +74,11 @@ hide:
   <input type="checkbox" id="clan-readmore" class="clamp-toggle" />
   <div class="clamp-content">
     <p><a href="https://clan.lol/">Clan</a> is a peer-to-peer computer management framework that empowers you to selfhost in a reliable and scalable way</strong>.</p>
-    <p>Built on NixOS, Clan provides a declarative interface for managing machines</strong> with <a href="/guides/vars/vars-overview/">Resource management</a>, <a href="guides/networking/networking/">Networking</a>, and <a href="
+    <p>Built on NixOS, Clan provides a declarative interface for managing machines</strong> with <a href="/guides/vars/vars-overview/">Resource management</a>, <a href="/guides/networking/networking/">Networking</a>, and <a href="
     /guides/backups/backup-intro/">Backups</a>.</p>
     <p>Whether you're running a homelab or maintaining critical computing infrastructure, Clan will help reduce maintenance burden</strong> by allowing a git repository to define your whole network</strong> of computers.</p>
     <p>In combination with <a href="https://github.com/Mic92/sops-nix">sops-nix</a>, <a href="https://github.com/nix-community/nixos-anywhere">nixos-anywhere</a> and <a href="https://github.com/nix-community/disko">disko</a>, Clan makes it possible to have collaborative infrastructure</strong>.</p>
-    <p>At the heart of Clan are <a href="/reference/clanServices">Clan Services</a> - the core concept that enables you to add functionality across multiple machines in your network. While Clan ships with essential core services, everyone can <a href="/guides/services/community/">create custom services</a> tailored to your specific needs.</p>
+    <p>At the heart of Clan are <a href="/services/official/">Clan Services</a> - the core concept that enables you to add functionality across multiple machines in your network. While Clan ships with essential core services, everyone can <a href="/guides/services/community/">create custom services</a> tailored to your specific needs.</p>
   </div>
   <label class="clamp-more" for="clan-readmore"></label>
 </div>