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

# Usually "experimental" or "deprecated"
kind:
# "xp" or "dp"
kindShort:

with builtins;
with import ./utils.nix;

let
  showExperimentalFeature = name: doc: ''
    - [`${name}`](@docroot@/contributing/${kind}-features.md#${kindShort}-feature-${name})
  '';
in
xps: indent "  " (concatStrings (attrValues (mapAttrs showExperimentalFeature xps)))
libexpr: Introduce Deprecated features They are like experimental features, but opt-in instead of opt-out. They will allow us to gracefully remove language features. See #437 Change-Id: I9ca04cc48e6926750c4d622c2b229b25cc142c42 2024-07-13 03:24:41 +00:00			`# Usually "experimental" or "deprecated"`
			`kind:`
			`# "xp" or "dp"`
			`kindShort:`

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

			`let`
Format Nix code with `nixfmt` Change-Id: I61efeb666ff7481c05fcb247168290e86a250151 2024-04-04 23:07:44 +00:00			`showExperimentalFeature = name: doc: ''`
libexpr: Introduce Deprecated features They are like experimental features, but opt-in instead of opt-out. They will allow us to gracefully remove language features. See #437 Change-Id: I9ca04cc48e6926750c4d622c2b229b25cc142c42 2024-07-13 03:24:41 +00:00			- [`${name}`](@docroot@/contributing/${kind}-features.md#${kindShort}-feature-${name})
Format Nix code with `nixfmt` Change-Id: I61efeb666ff7481c05fcb247168290e86a250151 2024-04-04 23:07:44 +00:00			`'';`
			`in`
			`xps: indent " " (concatStrings (attrValues (mapAttrs showExperimentalFeature xps)))`