flake: rename packages.«system».docs to packages.«system».doc

[MattSturgeon]

Rename the docs package -> doc, as discussed in #1272 (comment).

packages.«system».docs will be defined until 25.11 becomes the "oldest supported release"¹ and will always warn when evaluated.

Introduce a perSystem.stylix.aliases option so that different flake modules can query which aliases exist. This is used in flake/packages.nix to remove aliases from the checks output. The submodule is a little over-engineered for defining one alias, but may be useful if you end up adding more. For example, even though #1328 is a new addition, it may be beneficial to also have an apps.«system».docs alias to avoid confusion.

Things done

• Tested locally
• Tested in testbed
• Commit message follows commit convention
• Fits style guide
• Respects license of any existing code used

Notify maintainers

Footnotes

1. This will happen shortly after 25.05 is marked "unmaintained", a few weeks into the 26.11 unstable cycle. ↩

[0xda157]

LGTM

[trueNAHO]

Introduce a stylix.perSystemAliases option so that different flake modules can query which aliases exist. This is used in flake/packages.nix to remove aliases from the checks output. The submodule is a little over-engineered for defining one alias, but may be useful if you end up adding more. For example, even though #1328 is a new addition, it may be beneficial to also have an apps.«system».docs alias to avoid confusion.

Looks great!

[MattSturgeon]

I've updated this to take the new nix run .#docs app into account.

---

I've cleaned up the option by moving it into the perSystem submodule and then transposing its value into the flake submodule.

This means the aliases are "invisible"¹ within the perSystem submodule and only get added to the respective output attrs outside of perSystem (in flake). Therefore, it is not necessary to filter out alias names when copying packages to checks.

I haven't put any work into refactoring the top-level non-per-system aliases in this PR, as I feel that is out of scope.

Footnotes

1. Within perSystem, aliases can be read from the stylix.aliases option, but not from (e.g.) the packages option. ↩

[0xda157]

LGTM

[stylix-automation]

Successfully created backport PR for release-25.05:

• [release-25.05] flake: rename packages.«system».docs to packages.«system».doc #1457