Michael Hoang
dc108cc27d
docs: format code blocks in migration guide
2025-05-22 14:12:40 +10:00
Michael Hoang
dcb9358e51
docs: clean up flake-parts guide
2025-05-22 14:12:40 +10:00
Michael Hoang
5bc6126873
docs: misc clean up
2025-05-22 00:01:01 +10:00
hsjobeki
15f0ea616c
Merge pull request 'Refactor(docs): consistent structure across references & fix broken cli links' ( #3724 ) from hsjobeki/clan-core:docs-3 into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3724
2025-05-21 07:23:16 +00:00
Johannes Kirschbauer
3285efa55d
docs: exclude options that are not modules from clan.core submodule index
2025-05-21 09:11:18 +02:00
Johannes Kirschbauer
188e6d5d16
Docs: add links to submodules
2025-05-20 18:49:35 +02:00
Johannes Kirschbauer
b1054e2ad2
Fix(docs): rename reference to clan.core
2025-05-20 18:49:35 +02:00
Johannes Kirschbauer
db666ce2ce
Refactor(docs): consistent structure across references
2025-05-20 18:49:35 +02:00
Johannes Kirschbauer
a9ed972834
docs: fix clan-core should be called clan.core
...
Consistent with the module name
2025-05-20 18:49:35 +02:00
Johannes Kirschbauer
c34b693a64
docs: consistent clan-core overview
2025-05-20 18:49:35 +02:00
Jörg Thalheim
6dab14c9d4
docs/macos: replace duplicate section
2025-05-20 18:48:36 +02:00
lassulus
e5f38db60f
ADR: init 05-deployment-parameters
2025-05-20 16:22:52 +02:00
lassulus
131c7ea263
Merge pull request 'ADR: add decision for nix-select' ( #3452 ) from select-adr into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3452
Reviewed-by: hsjobeki <hsjobeki@gmail.com >
2025-05-20 13:43:31 +00:00
lassulus
6b3509c3b1
ADR: add decision for nix-select
2025-05-20 15:26:53 +02:00
Jörg Thalheim
4f4c44c7d4
add documentation on how to use macOS
2025-05-20 12:56:02 +02:00
pinpox
6525b591e2
docs: add glossary
2025-05-19 11:41:00 +02:00
Johannes Kirschbauer
88f7b3410e
Docs: unify 'manual' with 'guides' folder
...
This is one of the final steps towards strictly following
https://diataxis.fr/
2025-05-18 20:40:40 +02:00
Johannes Kirschbauer
b36d641e71
Docs: move {flake, facts-vars} migration guides into 'migrations' folder
2025-05-18 18:56:03 +02:00
Johannes Kirschbauer
04146eeac9
Docs: remove useless repo-layout file
2025-05-18 18:49:29 +02:00
Johannes Kirschbauer
3051763cbf
Docs: remove dafts folder
2025-05-18 18:48:23 +02:00
Johannes Kirschbauer
df5010084f
Docs: create migrations subfolder in guides
2025-05-18 18:46:36 +02:00
Johannes Kirschbauer
e9278ceaba
Docs: place reference to new ClanModules on index page
2025-05-18 18:40:10 +02:00
Johannes Kirschbauer
0261a954de
Docs: move 'getting-started' into guides section
2025-05-18 18:35:11 +02:00
Johannes Kirschbauer
ad5bbdbee0
Docs: move {contributing, disk, mesh, backups} into guides
2025-05-18 18:22:32 +02:00
hsjobeki
1bcf5a82a6
Merge pull request 'refactor: move clan_cli.error to clan_lib.error' ( #3677 ) from hsjobeki/clan-core:chores-1 into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3677
2025-05-16 15:17:41 +00:00
hsjobeki
fa270cf74c
Merge pull request 'Docs: init migration guide for clanServices' ( #3679 ) from service-docs into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3679
2025-05-16 14:39:22 +00:00
Johannes Kirschbauer
9221231e89
docs: move authoring guides into guides subfolder
2025-05-16 16:33:39 +02:00
Johannes Kirschbauer
868db1e6f3
Docs: init migration guide for clanServices
2025-05-16 16:15:51 +02:00
Johannes Kirschbauer
f210b2f9a6
refactor: move clan_cli.error to clan_lib.error
2025-05-16 16:14:39 +02:00
hsjobeki
56f3fd0a45
Merge pull request 'Docs for clan service options' ( #3670 ) from service-docs into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3670
2025-05-16 13:02:28 +00:00
Johannes Kirschbauer
21f87f169a
Docs: improve clanService docs
2025-05-16 14:58:46 +02:00
pinpox
8220c32142
Add clanServices to docs
...
Renders the documentation for clanServices. Options for the modules are
extracted and rendered the same way as for the existing clanModules.
Additionally tweaks the typography for the documentation of options
slightly
2025-05-16 11:29:50 +02:00
Jörg Thalheim
cc20e0bf35
clan-ui: remove intermediate app directory
2025-05-15 14:56:04 +02:00
Jörg Thalheim
2561e3e4d1
rename ui to clan-app and move clan-app one layer up
2025-05-15 14:15:59 +02:00
Brian McGee
c26cc9503c
feat: group ui related packages under a ui directory
2025-05-15 12:00:24 +01:00
pinpox
0e1831d0f4
add back old module for compatibility
2025-05-14 16:19:55 +02:00
Johannes Kirschbauer
d825a3348b
docs(adrs): move decision folder into docs to make them publicly visible within docs
2025-05-14 10:06:24 +02:00
a-kenji
9f805b9e46
docs/index: Surface reference documentation
2025-05-13 10:51:22 +00:00
Jörg Thalheim
028a401931
docs/devshell: make sure we are in the right directory before symlinking files
2025-05-13 12:24:20 +02:00
a-kenji
21aa95b139
docs/guides: Fix typos in migration guide
2025-05-13 10:33:23 +02:00
a-kenji
14969c5822
docs/guides: facts vars migration guide
...
Add a migration guide from facts to vars.
2025-05-13 08:10:32 +00:00
Johannes Kirschbauer
3c157c4a31
Docs: init empty migration guide with references
2025-05-12 16:13:08 +02:00
Johannes Kirschbauer
a87ab490a3
Fix: update test and docs
2025-05-12 15:54:50 +02:00
Jörg Thalheim
c0d2787dee
docs/testing: update to latest api
2025-05-12 13:03:06 +02:00
Johannes Kirschbauer
d5f90b2730
Docs: update 'clan.service' examples
2025-05-11 15:46:16 +02:00
Mic92
2d97119a3b
Merge pull request 'Avoid a few cases of chmod-after-creation' ( #3438 ) from tangential/clan-core:it-s_a_race into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3438
2025-05-04 07:08:43 +00:00
a-kenji
4c1e346cf2
docs/reference: Improve wording of reference overview
...
There is no value in calling it "automatically extracted" - but it is
potentially misleading.
2025-04-30 10:19:12 +00:00
Brian McGee
a438fe77a7
feat: configure age plugins for SOPS in buildClan
2025-04-29 16:02:32 +10:00
Brian McGee
1694a977f1
feat: support age plugins
...
Extends how we parse the contents of `SOPS_AGE_KEY` / `SOPS_AGE_KEY_FILE` / `keys.txt`, allowing a user to prepend a comment before any `AGE-PLUGIN-` secret key entry to indicate its corresponding public key.
For example:
```
AGE-PLUGIN-FIDO2-HMAC-xxxxxxxxxxxxx
```
The comment can use any prefix (e.g. `# public key: age1xxxx`, `# recipient: age1xxx`) as we are looking directly for `age1xxxx` within the line.
This change is necessary to support `age` plugins as there is no unified mechanism to recover the public key from a plugin's secret key.
If a plugin secret key does not have a preceding public key comment, an error will be thrown when attempting to set a secret.
2025-04-29 15:47:54 +10:00
Jonathan Thiessen
839f8fb347
Avoid a few cases of chmod-after-creation
2025-04-28 17:11:21 -07:00
