From 7f3f0f2a0b98cf05a04fe6d1c305856afb3370b7 Mon Sep 17 00:00:00 2001
From: osbm <osbm@osbm.dev>
Date: Thu, 2 Oct 2025 10:44:30 +0300
Subject: [PATCH] docs: Update documentation regarding the flake outputs

---
 src/nix/flake-check.md | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/src/nix/flake-check.md b/src/nix/flake-check.md
index c8307f8d8..007640c27 100644
--- a/src/nix/flake-check.md
+++ b/src/nix/flake-check.md
@@ -31,39 +31,49 @@ at the first error.
 The following flake output attributes must be derivations:
 
 * `checks.`*system*`.`*name*
-* `defaultPackage.`*system*
-* `devShell.`*system*
+* `devShells.`*system*`.default`
 * `devShells.`*system*`.`*name*
 * `nixosConfigurations.`*name*`.config.system.build.toplevel`
+* `packages.`*system*`.default`
 * `packages.`*system*`.`*name*
 
 The following flake output attributes must be [app
 definitions](./nix3-run.md):
 
+* `apps.`*system*`.default`
 * `apps.`*system*`.`*name*
-* `defaultApp.`*system*
 
 The following flake output attributes must be [template
 definitions](./nix3-flake-init.md):
 
-* `defaultTemplate`
+* `templates.default`
 * `templates.`*name*
 
 The following flake output attributes must be *Nixpkgs overlays*:
 
-* `overlay`
+* `overlays.default`
 * `overlays.`*name*
 
 The following flake output attributes must be *NixOS modules*:
 
-* `nixosModule`
+* `nixosModules.default`
 * `nixosModules.`*name*
 
 The following flake output attributes must be
 [bundlers](./nix3-bundle.md):
 
+* `bundlers.default`
 * `bundlers.`*name*
-* `defaultBundler`
+
+Old default attributes are renamed, they will work but will emit a warning:
+
+* `defaultPackage.<system>` → `packages.`*system*`.default`
+* `defaultApps.<system>` → `apps.`*system*`.default`
+* `defaultTemplate` → `templates.default`
+* `defaultBundler.<system>` → `bundlers.`*system*`.default`
+* `overlay` → `overlays.default`
+* `devShell.<system>` → `devShells.`*system*`.default`
+* `nixosModule` → `nixosModules.default`
 
 In addition, the `hydraJobs` output is evaluated in the same way as
 Hydra's `hydra-eval-jobs` (i.e. as a arbitrarily deeply nested