docs: update README

README.md

@@ -32,7 +32,7 @@ this is just the name of the programming language you want to use; the
 repository will pick a recommended default template for that language.
 
 If you want more control over the generated repository, you may select a
-specific template instead. Templates names are organized by underscore-separated
+specific template instead. Template names are made of underscore (`_`) separated
 *fields*; the number of fields may very depending on the language, but typically
 there are three or four:
 

flake.nix

@@ -6,6 +6,15 @@
       concatMapAttrs = func: attr:
        foldl' (x: y: x // y) {} (map func attr);
 
+      # Display names of languages for template descriptions
+      display-names = {
+        bash = "Bash";
+        fish = "Fish";
+        c = "C";
+        python = "Python";
+        rust = "Rust";
+      };
+
       # Template Aliases
       # Used to pick default template for each language
       aliases = {
@@ -33,19 +42,18 @@
             map (l: [ subd ] ++ l) (flakeSubdirs /${dir}/${subd}))
           (subdirs dir);
 
-      generateDesc = subds:
-        "${head subds} template - ${concatStringsSep ", " (tail subds)}";
+      generateDesc = fields:
+        let
+          lang = head fields;
+        in "${display-names.${lang} or lang} template (${concatStringsSep ", " (tail fields)})";
     in {
-      templates = concatMapAttrs (subds: {
-        ${concatStringsSep "_" subds} = {
-          description = generateDesc subds;
+      templates = concatMapAttrs (fields: {
+        ${concatStringsSep "_" fields} = {
+          description = generateDesc fields;
           path = filterSource
             (p: _: !(elem (baseNameOf p) template-ignore))
-            (foldl' (dir: subd: /${dir}/${subd}) ./. subds);
+            (foldl' (dir: subd: /${dir}/${subd}) ./. fields);
         };
-      }) (flakeSubdirs ./.) // mapAttrs (from: to:
-        self.templates.${to} // {
-          description = generateDesc (filter (p: p != []) (split "_" to));
-        }) aliases;
+      }) (flakeSubdirs ./.) // mapAttrs (from: to: self.templates.${to}) aliases;
     };
 }