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

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

let
  showExperimentalFeature = name: doc:
    squash ''
      ## [`${name}`]{#xp-feature-${name}}

      ${doc}
    '';
in xps: (concatStringsSep "\n" (attrValues (mapAttrs showExperimentalFeature xps)))
Assemble experimental feature docs outside of Nix itself Instead of constructing a markdown list in C++ (which involved all sorts of nasty string literals), export some JSON and assemble it with the manual build system. Besides following the precedent set with other dumped data, this is a better separate of content and presentation; if we decide for example we want to display this information in a different way, or in a different section of the manual, it will become much easier to do so. 2023-04-05 02:57: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>;`
Assemble experimental feature docs outside of Nix itself Instead of constructing a markdown list in C++ (which involved all sorts of nasty string literals), export some JSON and assemble it with the manual build system. Besides following the precedent set with other dumped data, this is a better separate of content and presentation; if we decide for example we want to display this information in a different way, or in a different section of the manual, it will become much easier to do so. 2023-04-05 02:57:11 +00:00
			`let`
Single page for experimental feature descriptions As requested by @fricklerhandwerk. 2023-04-09 15:01:23 +00:00			`showExperimentalFeature = name: doc:`
			`squash ''`
			## [`${name}`]{#xp-feature-${name}}
Assemble experimental feature docs outside of Nix itself Instead of constructing a markdown list in C++ (which involved all sorts of nasty string literals), export some JSON and assemble it with the manual build system. Besides following the precedent set with other dumped data, this is a better separate of content and presentation; if we decide for example we want to display this information in a different way, or in a different section of the manual, it will become much easier to do so. 2023-04-05 02:57:11 +00:00
Single page for experimental feature descriptions As requested by @fricklerhandwerk. 2023-04-09 15:01:23 +00:00			`${doc}`
			`'';`
			`in xps: (concatStringsSep "\n" (attrValues (mapAttrs showExperimentalFeature xps)))`