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

with builtins;
with import ./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;`
			`with import ./utils.nix;`

			`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)))`