Update default settings.json experience

src/cascadia/TerminalApp/userDefaults.json

@@ -1,35 +1,42 @@
+// This file was stamped by %PRODUCT% %VERSION%
+// It should still be usable in newer versions, but newer versions might have additional
+// settings, help text, or changes that you will not see unless you clear this file
+// and let us generate a new one for you.
+
 // To view the default settings, hold "alt" while clicking on the "Settings" button.
 // For documentation on these settings, see: https://aka.ms/terminal-documentation
 {
     "$schema": "https://aka.ms/terminal-profiles-schema",
 
     "defaultProfile": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}",
 
-    // You can add more global application settings up here!
+    // You can add more global application settings here.
     // To learn more about global settings, visit https://aka.ms/terminal-global-settings
 
-    // If enabled, selections are automatically copied to your clipboard
+    // If enabled, selections are automatically copied to your clipboard.
     "copyOnSelect": false,
 
-    // Profiles are listed in your dropdown and they include the command line executable along with customizations
+    // A profile specifies a command to execute paired with information about how it should look and feel.
+    // Each one of then will appear in the 'New Tab' dropdown,
+    //   and can be invoked from the commandline with `wt.exe -p xxx`
     // To learn more about profiles, visit https://aka.ms/terminal-profile-settings
     "profiles":
     {
         "defaults":
         {
-            // Put settings here that you want to apply to all profiles
+            // Put settings here that you want to apply to all profiles.
         },
         "list":
         [
             {
-                // Make changes here to the powershell.exe profile
+                // Make changes here to the powershell.exe profile.
                 "guid": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}",
                 "name": "Windows PowerShell",
                 "commandline": "powershell.exe",
                 "hidden": false
             },
             {
-                // Make changes here to the cmd.exe profile
+                // Make changes here to the cmd.exe profile.
                 "guid": "{0caa0dad-35be-5f56-a8ff-afceeeaa6101}",
                 "name": "cmd",
                 "commandline": "cmd.exe",
@@ -38,29 +45,28 @@
         ]
     },
 
-    // Add custom color schemes to this array
+    // Add custom color schemes to this array.
     // To learn more about color schemes, visit https://aka.ms/terminal-color-schemes
     "schemes": [],
 
-    // Add custom keybindings to this array
-    // To unbind a key combination from your defaults.json, set the command to "unbound"
+    // Add custom keybindings to this array.
+    // To unbind a key combination from your defaults.json, set the command to "unbound".
     // To learn more about keybindings, visit https://aka.ms/terminal-keybindings
     "keybindings":
     [
-        // Copy and paste are bound to Ctrl+Shift+C and Ctrl+Shift+V in your defaults.json
-        // These bindings additionally bind them to Ctrl+C and Ctrl+V
+        // Copy and paste are bound to Ctrl+Shift+C and Ctrl+Shift+V in your defaults.json.
+        // These two lines additionally bind them to Ctrl+C and Ctrl+V.
         // To learn more about selection, visit https://aka.ms/terminal-selection
         { "command": "copy", "keys": "ctrl+c" },
         { "command": "paste", "keys": "ctrl+v" },
 
         // Press Ctrl+Shift+F to open the search box
-        // To learn more about selection, visit https://aka.ms/terminal-search
         { "command": "find", "keys": "ctrl+shift+f"},
 
-        // Press Alt+Shift+D to open a new pane
-        // - "split": "auto" makes this pane open in the direction that provides the most surface area
-        // - "splitMode": "duplicate" makes this pane a duplicate of the focused pane's profile
-        // To learn more about selection, visit https://aka.ms/terminal-panes
+        // Press Alt+Shift+D to open a new pane.
+        // - "split": "auto" makes this pane open in the direction that provides the most surface area.
+        // - "splitMode": "duplicate" makes this pane a duplicate of the focused pane's profile.
+        // To learn more about panes, visit https://aka.ms/terminal-panes
         { "command": { "action": "splitPane", "split": "auto", "splitMode": "duplicate" }, "keys": "alt+shift+d" }
     ]
 }