nix/doc/manual/generate-xp-features-shortlist.nix

with builtins;
with import <nix/utils.nix>;

let
  showExperimentalFeature = name: doc:
    ''
      - [`${name}`](@docroot@/contributing/experimental-features.md#xp-feature-${name})
    '';
in xps: indent "  " (concatStrings (attrValues (mapAttrs showExperimentalFeature xps)))
Describe active experimental features in the contributing guide They are put in the manual separate pages under the new overarching description of experimental features. The settings page just lists the valid experimental feature names (so people know what a valid setting entry looks like), with links to those pages. It doesn't attempt to describe each experimental feature as that is too much information for the configuration settings section. 2023-04-06 16:24:11 +00:00			`with builtins;`
use lookup paths in helper expressions consistently this makes the files in question a bit more independent of source location. to find where the value is set and how it's wired up: rg nix=doc/manual 2023-11-30 20:41:47 +00:00			`with import <nix/utils.nix>;`
Describe active experimental features in the contributing guide They are put in the manual separate pages under the new overarching description of experimental features. The settings page just lists the valid experimental feature names (so people know what a valid setting entry looks like), with links to those pages. It doesn't attempt to describe each experimental feature as that is too much information for the configuration settings section. 2023-04-06 16:24:11 +00:00
			`let`
			`showExperimentalFeature = name: doc:`
			`''`
Single page for experimental feature descriptions As requested by @fricklerhandwerk. 2023-04-09 15:01:23 +00:00			- [`${name}`](@docroot@/contributing/experimental-features.md#xp-feature-${name})
Describe active experimental features in the contributing guide They are put in the manual separate pages under the new overarching description of experimental features. The settings page just lists the valid experimental feature names (so people know what a valid setting entry looks like), with links to those pages. It doesn't attempt to describe each experimental feature as that is too much information for the configuration settings section. 2023-04-06 16:24:11 +00:00			`'';`
			`in xps: indent " " (concatStrings (attrValues (mapAttrs showExperimentalFeature xps)))`