Skip to content

docs(treefmt): describe the published check and the configurations left unpublished - #70

Closed
clhodapp wants to merge 11 commits into
docs/system-manager-pkgsfrom
docs/treefmt-check
Closed

clhodapp wants to merge 11 commits into
docs/system-manager-pkgsfrom
docs/treefmt-check

Conversation

@clhodapp

Copy link
Copy Markdown
Contributor

Documents nix-caisson/caisson#108. The treefmt configuration named default is published as checks.<system>.treefmt, its check over the root of the tree, as well as formatter.<system>. A configuration under any other name is published in no output, and is found through the manifest. The reference for exportsTo now says it may be a list of exports, and that an export may carry only. mdbook build succeeds.

🤖 Generated with Claude Code

clhodapp and others added 11 commits October 17, 2026 23:40
This documents nix-caisson/caisson#99: the nvf integration, the Neovim
it publishes as `packages.<system>.<name>`, and the `nvf-package`
module with which the machines, homes and hjem configurations install
the Neovim of an nvf configuration declared inside them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This documents nix-caisson/caisson#100: the nixvim integration, the
evaluation it makes as `evalNixvim` makes it, the
`nixvimConfigurations.<system>.<name>` it publishes, and the nixvim
ecosystem source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This documents nix-caisson/caisson#101: the topology integration and
the machines declared inside it, the kubenix and nixidy integrations
and what each publishes, their ecosystem sources, and
`caisson.modules` holding the export settings of every class in one
option.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…inside them

A system-manager configuration activates the homes and the hjem
configurations declared inside it, and installs the Neovim of the nvf
configurations declared inside it, with its registered default module.
The reference gains the entry for that module and names the class in
the nvf and hjem passages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…and the one above it

The reference section for the two marker modules of a home inside a
NixOS machine becomes the section for the mechanism every configuration
with an activation uses: the identity and marker each activating
integration records, the marker each class writes, and the check. The
option `caisson.home-manager.machineDrift.warn` is documented as
`caisson.drift.warn`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ctivates

The reference gains a section on profiles: the outputs
`activationPackage` and `profile`, where each class keeps and
activates them, the reset at every activation of the configuration
above, and the programs and `CAISSON_NVIM_PROFILE` that choose among
them. The option `caisson.profiles.selected` is documented, and
`caisson.drift.warn` covers nvf and nixvim. The install modules
`nvf-package` and `packagesModule` are gone from the reference, the
home marker is under `$HOME/.local/state`, and four passages say
"evaluated per system".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
hjem is pronounced with a leading "y" sound, so it takes "a".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…files

Three passages said a configuration is evaluated at a system or at every
system in force; they say it is evaluated per system, once for each.
The system-manager entry said a system-manager configuration installs
the Neovim of nvf configurations; it activates the profiles of the nvf
and nixvim configurations declared inside it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ft unpublished

The configuration named `default` is published as
`checks.<system>.treefmt`, its check over the root of the tree, besides
`formatter.<system>`. A configuration under another name is published
nowhere and is found through the manifest. `exportsTo` may be a list
of exports, and an export may carry `only`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp clhodapp self-assigned this Oct 18, 2026
@clhodapp
clhodapp added this pull request to stack #68 October 18, 2026 07:24
@clhodapp

Copy link
Copy Markdown
Contributor Author

Folded into #61, the treefmt docs, and the stack restacked onto it.

@clhodapp clhodapp closed this Oct 18, 2026
An error occurred while trying to automatically change base from docs/system-manager-pkgs to main October 18, 2026 19:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant