Johannes Kirschbauer
1bc6d8c046
deploy: add warning about disko.nix
2025-07-13 21:26:07 +02:00
hsjobeki
4cc149b3c3
Merge pull request 'api/modules: remove redundant localModules' ( #4322 ) from api-modules into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4322
2025-07-13 12:05:11 +00:00
Johannes Kirschbauer
86db003973
lib/modules: move from api to services module
2025-07-13 13:57:02 +02:00
Johannes Kirschbauer
0ac0b422e6
docs/users: add explanation for groups
2025-07-13 11:33:22 +02:00
Johannes Kirschbauer
2ecb9a533d
docs/getting-started: seperate step to add a user
2025-07-13 11:31:14 +02:00
Johannes Kirschbauer
8c1587e400
docs/deploy: remove unneeded --update-hardware-config nixos-facter
2025-07-12 17:48:13 +02:00
Johannes Kirschbauer
318cc4b1ec
Templates/cli: improve ux and docs
2025-07-12 17:21:23 +02:00
Johannes Kirschbauer
f362cfb983
Docs: fix code annotations
2025-07-12 16:40:02 +02:00
Johannes Kirschbauer
66ddc399d0
Docs: fix typos
2025-07-12 16:39:20 +02:00
Johannes Kirschbauer
20a6375c2a
Docs: align workflow, remove targetHost before deployment
2025-07-12 16:35:43 +02:00
Johannes Kirschbauer
2882e9e8da
Docs: rewrite deployment instructions
2025-07-12 16:35:43 +02:00
Johannes Kirschbauer
2c910f8616
docs: add guide how to create configuration.nix
2025-07-12 16:35:43 +02:00
Johannes Kirschbauer
5e80e0a833
docs: add service update instructions
2025-07-12 16:35:43 +02:00
Johannes Kirschbauer
055cf3d924
docs: add machines update instructions
2025-07-12 16:35:43 +02:00
Johannes Kirschbauer
3d8ddd1be1
docs: create clan update cli instructions
2025-07-12 16:35:41 +02:00
a-kenji
2439d508ef
pkgs/clan: Fix command typos
2025-07-12 13:54:37 +02:00
Johannes Kirschbauer
461c628a98
diskId: add migration docs and a big fat warning
2025-07-11 20:47:53 +02:00
pinpox
58a06d2261
Migrate data-mesher to clan service
2025-07-10 12:30:29 +02:00
hsjobeki
9300fd9dc7
Merge pull request 'refactor: move docs transformOptions to clanLib to reduce rebuilds' ( #4259 ) from self into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4259
2025-07-09 15:31:25 +00:00
Johannes Kirschbauer
dd1429c89f
Docs: fix rendering clan source code url
2025-07-09 17:24:20 +02:00
Jörg Thalheim
8d4099d13d
refactor: move docs transformOptions to clanLib to reduce rebuilds
...
- Add clanLib.docs.stripStorePathsFromDeclarations to deduplicate code
- Update all documentation generation to use the shared function
- This strips store paths from option declarations to prevent options.json
from rebuilding when only store paths change but content remains the same
- Reduces unnecessary documentation rebuilds when making unrelated changes
2025-07-09 16:59:58 +02:00
Johannes Kirschbauer
c65b35edc1
docs: disable footer navigation
...
This gives the content more space
Especially for plugins (options, developer tabs)
2025-07-08 16:38:33 +02:00
Johannes Kirschbauer
62cadb8fbe
Docs: mention clan.nix file, which is present in the default template now
2025-07-08 14:58:24 +02:00
Johannes Kirschbauer
05658589a0
Docs: execute 'clan show' as first step
2025-07-08 10:24:01 +02:00
Johannes Kirschbauer
14a221d1d1
Docs: remove 'replaces' sentence; it is not describing any purpose
2025-07-08 10:01:51 +02:00
hsjobeki
9739a5ae2b
Merge pull request 'templates: rename 'new_clan' to default' ( #4244 ) from templates into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4244
2025-07-08 07:31:22 +00:00
Jörg Thalheim
6a6688019b
docs: no longer depend on self
2025-07-07 20:24:11 +02:00
Jörg Thalheim
9c37ef4cbe
add dev flake pattern
...
This allows us to have dev dependencies which are not propagated to the user.
2025-07-07 15:59:09 +00:00
Johannes Kirschbauer
0dce3fc7ec
templates: rename 'new_clan' to default
2025-07-07 15:50:00 +00:00
hsjobeki
0cd9c84de0
Merge pull request 'machine/host: degrade into info and add docs' ( #4238 ) from host-info into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4238
Reviewed-by: Luis Hebendanz <consulting@qube.email >
2025-07-07 11:10:05 +00:00
Johannes Kirschbauer
a2a011a47f
machine/host: degrade into info and add docs
2025-07-07 11:52:46 +02:00
Michael Hoang
e6785fa1d0
treewide: don't generate SSH keys with builder hostname
2025-07-07 14:39:57 +10:00
Michael Hoang
08c15b3d9b
docs: remove colon from headings
2025-07-07 13:54:26 +10:00
Johannes Kirschbauer
cd04686663
Docs: update index
2025-07-06 20:06:17 +02:00
hsjobeki
899051a570
Merge pull request 'clan_lib/openapi: add openapi rendering' ( #4200 ) from lib-openapi into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4200
2025-07-04 11:54:13 +00:00
Johannes Kirschbauer
62c1db9769
Docs: init redoc internal rest inspired docs
2025-07-04 12:45:39 +02:00
DavHau
969b7606a6
reverting 4c2bb0791d
2025-07-04 10:35:30 +07:00
Johannes Kirschbauer
e0993559db
docs: add zerotier debugging commands
2025-07-03 16:25:10 +02:00
Johannes Kirschbauer
b27ed51284
docs: update vpn setup instructions
2025-07-03 12:04:56 +02:00
Johannes Kirschbauer
a81701b59a
docs: fix wrong roles assignment syntax
2025-07-03 11:42:26 +02:00
hsjobeki
b2e8b8bf59
Merge pull request 'clan.deployment: unify deprecated options' ( #4184 ) from cli-fix into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4184
2025-07-02 16:48:19 +00:00
Johannes Kirschbauer
4c2bb0791d
clan.deployment: unify deprecated option
2025-07-02 18:37:29 +02:00
Johannes Kirschbauer
fb5dca567e
docs/secrets: setup move plugins section to the bottom. Normal users don't have that, smart people read from bottom up
2025-07-02 18:23:48 +02:00
Johannes Kirschbauer
58c9c929ba
docs/index: add progress tracker, encourage non-linear flow
2025-07-02 17:02:16 +02:00
Johannes Kirschbauer
58862215ab
docs: rephrase add machines for planned dynamic templates
2025-07-02 17:01:40 +02:00
Johannes Kirschbauer
667bbffb3f
docs: add emojis to getting-started
2025-07-02 17:00:51 +02:00
Johannes Kirschbauer
0bd4074927
docs: clarify project structure exploration in Getting Started
2025-07-02 16:32:30 +02:00
Johannes Kirschbauer
faf6ac82eb
docs: remove api reference build command
2025-07-02 15:53:48 +02:00
Johannes Kirschbauer
6c7beb7aaa
docs: remove step numbers
...
Numerating steps is not informative and considered bad style
People tend to follow documentation non-linearly
leaving of at one point, starting over from the middle
Documentation should be written in a way that allow for that
2025-07-02 15:53:24 +02:00
Johannes Kirschbauer
695574988e
Revert "Merge pull request 'Make state-version generation an clan option' ( #4056 ) from state-version-option into main"
...
This reverts commit a101ff1f11 , reversing
changes made to f12b62d8b4 .
2025-07-01 18:15:11 +02:00