doc: implement custom option list generation (#955)

Implement a custom option list generation with a pkgs.nixosOptionsDoc
variant that evaluates each platform configuration only once.

This resolves [1] ("doc: avoid excessive calls to pkgs.nixosOptionsDoc")
and unblocks [2] ("ci: too many matrix jobs").

With the gained flexibility, option details are now rendered as tables.

[1]: https://github.com/danth/stylix/issues/896
[2]: https://github.com/danth/stylix/issues/947

Closes: https://github.com/danth/stylix/issues/896
Link: https://github.com/danth/stylix/pull/955

Reviewed-by: NAHO <90870942+trueNAHO@users.noreply.github.com>
This commit is contained in:
Daniel Thwaites 2025-03-14 18:04:49 +00:00 committed by GitHub
parent 6a2e525887
commit 52b1cc7247
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 452 additions and 131 deletions

View file

@ -17,12 +17,6 @@
# Reference
<!--
The auto-generated list of modules is appended to this file, so this must
be the last section, and modules must be the last page, with no comments
following it. There must be a trailing newline.
The generated list of platforms and modules is appended to this file.
There must be a trailing newline below this comment.
-->
- [Platforms]() <!-- TODO: migrate general platforms content to this page. -->
- [Home Manager](options/platforms/home_manager.md)
- [NixOS](options/platforms/nixos.md)
- [Modules]() <!-- TODO: migrate general modules content to this page. -->