810 Commits

Author SHA1 Message Date
Johannes Kirschbauer
83278097f6 docs: add service update instructions 2025-07-12 16:35:43 +02:00
Johannes Kirschbauer
fb60ae8082 docs: add machines update instructions 2025-07-12 16:35:43 +02:00
Johannes Kirschbauer
4b8f83de9e docs: create clan update cli instructions 2025-07-12 16:35:41 +02:00
a-kenji
f97bbc946e pkgs/clan: Fix command typos 2025-07-12 13:54:37 +02:00
Johannes Kirschbauer
4800fec13c diskId: add migration docs and a big fat warning 2025-07-11 20:47:53 +02:00
pinpox
84b23489f7 Migrate data-mesher to clan service 2025-07-10 12:30:29 +02:00
hsjobeki
f9de0206eb 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
5c234ac643 Docs: fix rendering clan source code url 2025-07-09 17:24:20 +02:00
Jörg Thalheim
0e97efbbef 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
04fe1d2a8d 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
a9e50154d0 Docs: mention clan.nix file, which is present in the default template now 2025-07-08 14:58:24 +02:00
Johannes Kirschbauer
8d5740fd16 Docs: execute 'clan show' as first step 2025-07-08 10:24:01 +02:00
Johannes Kirschbauer
dfb3a45fa5 Docs: remove 'replaces' sentence; it is not describing any purpose 2025-07-08 10:01:51 +02:00
hsjobeki
8b7fdc776e 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
8b7bdc2b23 docs: no longer depend on self 2025-07-07 20:24:11 +02:00
Jörg Thalheim
8d3bd6b690 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
5d6a0c9883 templates: rename 'new_clan' to default 2025-07-07 15:50:00 +00:00
hsjobeki
5750f4bbe7 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
eaae9b0025 machine/host: degrade into info and add docs 2025-07-07 11:52:46 +02:00
Michael Hoang
ea1df1e9f4 treewide: don't generate SSH keys with builder hostname 2025-07-07 14:39:57 +10:00
Michael Hoang
a91756d54a docs: remove colon from headings 2025-07-07 13:54:26 +10:00
Johannes Kirschbauer
d4cbdcdc3b Docs: update index 2025-07-06 20:06:17 +02:00
hsjobeki
5b61c4253a 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
38b8722e2e Docs: init redoc internal rest inspired docs 2025-07-04 12:45:39 +02:00
DavHau
67a37a9d2c reverting b1f71fe4fb 2025-07-04 10:35:30 +07:00
Johannes Kirschbauer
0f6f0a6237 docs: add zerotier debugging commands 2025-07-03 16:25:10 +02:00
Johannes Kirschbauer
62ada9e1c2 docs: update vpn setup instructions 2025-07-03 12:04:56 +02:00
Johannes Kirschbauer
fe47157a7c docs: fix wrong roles assignment syntax 2025-07-03 11:42:26 +02:00
hsjobeki
93fc836e6b 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
b1f71fe4fb clan.deployment: unify deprecated option 2025-07-02 18:37:29 +02:00
Johannes Kirschbauer
35b426f943 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
54396e8744 docs/index: add progress tracker, encourage non-linear flow 2025-07-02 17:02:16 +02:00
Johannes Kirschbauer
bcebfc7b8e docs: rephrase add machines for planned dynamic templates 2025-07-02 17:01:40 +02:00
Johannes Kirschbauer
83b38e9e01 docs: add emojis to getting-started 2025-07-02 17:00:51 +02:00
Johannes Kirschbauer
2079fe06be docs: clarify project structure exploration in Getting Started 2025-07-02 16:32:30 +02:00
Johannes Kirschbauer
454e68615c docs: remove api reference build command 2025-07-02 15:53:48 +02:00
Johannes Kirschbauer
8097d491cd 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
8f6f06bef3 Revert "Merge pull request 'Make state-version generation an clan option' (#4056) from state-version-option into main"
This reverts commit 8a7b6d13b5, reversing
changes made to 7a4eeb5b16.
2025-07-01 18:15:11 +02:00
hsjobeki
abbf2c1083 Merge pull request 'Docs: getting started add services' (#4156) from doc into main
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4156
2025-06-30 14:16:00 +00:00
Johannes Kirschbauer
eab918324b Docs: getting started add services 2025-06-30 15:14:47 +02:00
DavHau
73b298d0b2 checks: rename attributes for better discoverability
- all eval checks prefixed with `eval-`
- all service checks prefixed with `service-`
2025-06-30 19:04:21 +07:00
hsjobeki
8b1e8201aa Merge pull request 'docs: move deployment docs from add machine to deploy' (#4153) from doc into main
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4153
2025-06-30 11:50:35 +00:00
Johannes Kirschbauer
ff52f38f87 Docs: rename installer to usb installer 2025-06-30 13:03:07 +02:00
Johannes Kirschbauer
e55220ed47 docs: move deployment docs from add machine to deploy 2025-06-30 13:02:57 +02:00
Johannes Kirschbauer
a7bca56487 docs: mark getting-started/flash installer as optional" 2025-06-30 13:02:46 +02:00
pinpox
ef3c22f240 Remove state-version module and service 2025-06-30 12:54:29 +02:00
DavHau
7a4eeb5b16 docs: explain about simplified way of specifying instances 2025-06-30 10:27:37 +00:00
Jörg Thalheim
97e52a6946 markdown: ignore trailing whitespace 2025-06-27 16:26:39 +02:00
Johannes Kirschbauer
731de62876 docs: rename all references from 'buildClan' to 'lib.clan' 2025-06-27 09:54:23 +02:00
Johannes Kirschbauer
9ef518fa20 refactor: unify evalClanService with evalService 2025-06-26 14:50:35 +02:00