Skip to content

docs(terranix,system-manager): document the configurations evaluated per system - #59

Merged
clhodapp merged 2 commits into
docs/darwin-childrenfrom
docs/terranix-system-manager
Oct 18, 2026
Merged

clhodapp merged 2 commits into
docs/darwin-childrenfrom
docs/terranix-system-manager

Conversation

@clhodapp

Copy link
Copy Markdown
Contributor

Documents nix-caisson/caisson#96: terranix and system-manager configurations work like the other integrations.

  • The terranix and system-manager sections of the reference cover the following:
    • how a configuration is registered, found by name and published, as terranixConfigurations.<name> and systemConfigs.<name>;
    • what its value and output are;
    • which package set it runs on;
    • how its modules see the composed library;
    • for terranix, why it holds no configurations beneath it.
  • The defaultPkgs and pkgSets conventions list the entry points as they are now.
  • caisson.modules.<class>.exported in the options reference has its new type. It now exports the modules as its function returns them.

This branch is based on docs/darwin-children (#58). Merge #56, #57 and #58 first, then change the base of this PR to main.

🤖 Generated with Claude Code

@clhodapp clhodapp self-assigned this Oct 17, 2026
@clhodapp clhodapp changed the title docs(terranix,system-manager): document the configurations evaluated at a system docs(terranix,system-manager): document the configurations evaluated per system Oct 17, 2026
@clhodapp
clhodapp added this pull request to stack #68 October 17, 2026 20:04
clhodapp and others added 2 commits October 18, 2026 10:37
…at a system

This documents nix-caisson/caisson#96: terranix and system-manager
configurations are configurations like the others, found by name,
evaluated at each system in force and published as
`terranixConfigurations` and `systemConfigs`. The conventions for
`defaultPkgs` and `pkgSets` follow, and `caisson.modules.<class>.exported`
exports the modules as its function returns them.

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

The reference said system-manager builds its package set from the
nixpkgs its flake pins and takes no `defaultPkgs`. A system-manager
configuration runs on the selected set and on the nixpkgs the
composition declares; the reference says how, lists `defaultPkgs`, and
names what is refused.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp
clhodapp force-pushed the docs/terranix-system-manager branch from da50e15 to 7381cb9 Compare October 18, 2026 17:37
@clhodapp
clhodapp merged commit ab5d35a into main Oct 18, 2026
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