Skip to content

docs: promote usage of Nix(OS) and discourage use of envbuilder - #31141

Merged
phorcys420 merged 40 commits into
mainfrom
docs/nix-alternatives
Oct 27, 2026
Merged

phorcys420 merged 40 commits into
mainfrom
docs/nix-alternatives

Conversation

@phorcys420

@phorcys420 phorcys420 commented Oct 21, 2026 •

Copy link
Copy Markdown
Member

Adds a Nix(OS) docs page (docs/admin/integrations/nixos.md) presenting Nix flakes as an alternative to dev containers. It covers both Nix on an existing distribution (e.g. a Debian image, via the Nix(OS) module's nix develop mode) and full NixOS workspaces (the AWS EC2 (NixOS) template). Both work in containers or VMs.

The page is added to the sidebar under Integrations, after Dev Containers. Other pages get one-line links to it:

  • Dev Containers overview (admin/integrations/devcontainers/index.md)
  • Image management, "Let developers customize their own environment"
  • Templates overview, Best Practices
  • Managing templates, Next steps
  • Extending templates, Dev Containers
  • Envbuilder (managing templates)
  • Dev Containers user guide intro

Generated with Xum using Claude

@github-actions

github-actions Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

Changed images

These images changed. Each is listed with the navigable page(s) that embed it, so you can open the preview and see the new image in context. An image with no page listed isn't embedded by any navigable docs page. These links are informational and have no review checkboxes.

  • docs/images/icons/nix.svg

@phorcys420 phorcys420 changed the title docs: add Nix(OS) page as a container-free alternative to dev containers docs: add Nix(OS) page as an alternative to dev containers Oct 26, 2026
@phorcys420 phorcys420 changed the title docs: add Nix(OS) page as an alternative to dev containers docs: promote usage of Nix(OS) and discourage use of envbuilder Oct 27, 2026
@phorcys420
phorcys420 marked this pull request as ready for review October 27, 2026 02:26

@nickvigilante nickvigilante left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved with changes. Thanks!

Comment thread docs/admin/templates/index.md Resolved
phorcys420 and others added 10 commits October 27, 2026 15:26
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>
@phorcys420
phorcys420 enabled auto-merge (squash) October 27, 2026 14:33
@phorcys420
phorcys420 disabled auto-merge October 27, 2026 14:33
@phorcys420
phorcys420 enabled auto-merge (squash) October 27, 2026 14:34
@phorcys420
phorcys420 merged commit 3ed2dfd into main Oct 27, 2026
28 checks passed
@phorcys420
phorcys420 deleted the docs/nix-alternatives branch October 27, 2026 15:24
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 27, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants