feat: add descriptions to Code Editor preferences and unify style across all settings (#709)

Author: antonreshetov

src/main/i18n/locales/cs_CZ/preferences.json

@@ -12,28 +12,51 @@
   },
   "editor": {
     "label": "Editor",
-    "fontSize": "Velikost písma",
-    "fontFamily": "Rodina písma",
+    "fontSize": {
+      "label": "Velikost písma",
+      "description": "Base font size in pixels for the code editor."
+    },
+    "fontFamily": {
+      "label": "Rodina písma",
+      "description": "Monospace font for the code editor. Use commas for fallbacks."
+    },
     "wrap": {
       "label": "Zalamování",
+      "description": "Line wrapping to fit the editor width or allow horizontal scrolling.",
       "wordWrap": "Zalamování slov",
       "off": "Vypnuto"
     },
-    "tabSize": "Velikost tabulátoru",
+    "tabSize": {
+      "label": "Velikost tabulátoru",
+      "description": "Number of spaces per tab character for indentation."
+    },
     "showInvisibles": "Zobrazit neviditelné znaky",
-    "highlightLine": "Zvýraznit řádek",
+    "highlightLine": {
+      "label": "Zvýraznit řádek",
+      "description": "Visual highlight on the line where the cursor is positioned."
+    },
     "highlightGutter": "Zvýraznit okraj",
-    "matchBrackets": "Párové závorky",
+    "matchBrackets": {
+      "label": "Párové závorky",
+      "description": "Matching bracket highlighting near the cursor."
+    },
     "prettier": {
       "label": "Prettier",
       "trailingComma": {
         "label": "Koncová čárka",
+        "description": "Trailing commas in multi-line structures when formatting.",
         "none": "Žádná",
         "all": "Všude",
         "es5": "ES5"
       },
-      "semi": "Středník",
-      "singleQuote": "Jednoduché uvozovky"
+      "semi": {
+        "label": "Středník",
+        "description": "Semicolons at the end of every statement."
+      },
+      "singleQuote": {
+        "label": "Jednoduché uvozovky",
+        "description": "Single quotes instead of double quotes."
+      }
     }
   },
   "notesEditor": {

src/main/i18n/locales/de_DE/preferences.json

@@ -12,28 +12,51 @@
   },
   "editor": {
     "label": "Editor",
-    "fontSize": "Schriftgröße",
-    "fontFamily": "Schriftart",
+    "fontSize": {
+      "label": "Schriftgröße",
+      "description": "Base font size in pixels for the code editor."
+    },
+    "fontFamily": {
+      "label": "Schriftart",
+      "description": "Monospace font for the code editor. Use commas for fallbacks."
+    },
     "wrap": {
       "label": "Umbruch",
+      "description": "Line wrapping to fit the editor width or allow horizontal scrolling.",
       "wordWrap": "Zeilenumbruch",
       "off": "Aus"
     },
-    "tabSize": "Tabgröße",
+    "tabSize": {
+      "label": "Tabgröße",
+      "description": "Number of spaces per tab character for indentation."
+    },
     "showInvisibles": "Unsichtbare Zeichen anzeigen",
-    "highlightLine": "Zeile hervorheben",
+    "highlightLine": {
+      "label": "Zeile hervorheben",
+      "description": "Visual highlight on the line where the cursor is positioned."
+    },
     "highlightGutter": "Zeilennummern hervorheben",
-    "matchBrackets": "Klammern hervorheben",
+    "matchBrackets": {
+      "label": "Klammern hervorheben",
+      "description": "Matching bracket highlighting near the cursor."
+    },
     "prettier": {
       "label": "Prettier",
       "trailingComma": {
         "label": "Abschließendes Komma",
+        "description": "Trailing commas in multi-line structures when formatting.",
         "none": "Keins",
         "all": "Alle",
         "es5": "ES5"
       },
-      "semi": "Semikolon",
-      "singleQuote": "Einfache Anführungszeichen"
+      "semi": {
+        "label": "Semikolon",
+        "description": "Semicolons at the end of every statement."
+      },
+      "singleQuote": {
+        "label": "Einfache Anführungszeichen",
+        "description": "Single quotes instead of double quotes."
+      }
     }
   },
   "notesEditor": {

src/main/i18n/locales/el_GR/preferences.json

@@ -12,28 +12,51 @@
   },
   "editor": {
     "label": "Editor",
-    "fontSize": "Μέγεθος Γραμματοσειράς",
-    "fontFamily": "Οικογένεια Γραμματοσειράς",
+    "fontSize": {
+      "label": "Μέγεθος Γραμματοσειράς",
+      "description": "Base font size in pixels for the code editor."
+    },
+    "fontFamily": {
+      "label": "Οικογένεια Γραμματοσειράς",
+      "description": "Monospace font for the code editor. Use commas for fallbacks."
+    },
     "wrap": {
       "label": "Αναδίπλωση",
+      "description": "Line wrapping to fit the editor width or allow horizontal scrolling.",
       "wordWrap": "Αναδίπλωση Λέξεων",
       "off": "Απενεργοποίηση"
     },
-    "tabSize": "Μέγεθος Tab",
+    "tabSize": {
+      "label": "Μέγεθος Tab",
+      "description": "Number of spaces per tab character for indentation."
+    },
     "showInvisibles": "Εμφάνιση Αόρατων Χαρακτήρων",
-    "highlightLine": "Επισήμανση Γραμμής",
+    "highlightLine": {
+      "label": "Επισήμανση Γραμμής",
+      "description": "Visual highlight on the line where the cursor is positioned."
+    },
     "highlightGutter": "Επισήμανση Gutter",
-    "matchBrackets": "Αντιστοίχιση Παρενθέσεων",
+    "matchBrackets": {
+      "label": "Αντιστοίχιση Παρενθέσεων",
+      "description": "Matching bracket highlighting near the cursor."
+    },
     "prettier": {
       "label": "Prettier",
       "trailingComma": {
         "label": "Κόμμα στο Τέλος",
+        "description": "Trailing commas in multi-line structures when formatting.",
         "none": "Κανένα",
         "all": "Όλα",
         "es5": "ES5"
       },
-      "semi": "Ερωτηματικό",
-      "singleQuote": "Μονά Εισαγωγικά"
+      "semi": {
+        "label": "Ερωτηματικό",
+        "description": "Semicolons at the end of every statement."
+      },
+      "singleQuote": {
+        "label": "Μονά Εισαγωγικά",
+        "description": "Single quotes instead of double quotes."
+      }
     }
   },
   "notesEditor": {

src/main/i18n/locales/en_US/preferences.json

@@ -12,28 +12,51 @@
   },
   "editor": {
     "label": "Code Editor",
-    "fontSize": "Font Size",
-    "fontFamily": "Font Family",
+    "fontSize": {
+      "label": "Font Size",
+      "description": "Base font size in pixels for the code editor."
+    },
+    "fontFamily": {
+      "label": "Font Family",
+      "description": "Monospace font for the code editor. Use commas for fallbacks."
+    },
     "wrap": {
       "label": "Wrap",
+      "description": "Line wrapping to fit the editor width or allow horizontal scrolling.",
       "wordWrap": "Word Wrap",
       "off": "Off"
     },
-    "tabSize": "Tab Size",
+    "tabSize": {
+      "label": "Tab Size",
+      "description": "Number of spaces per tab character for indentation."
+    },
     "showInvisibles": "Show Invisibles",
-    "highlightLine": "Highlight Line",
+    "highlightLine": {
+      "label": "Highlight Line",
+      "description": "Visual highlight on the line where the cursor is positioned."
+    },
     "highlightGutter": "Highlight Gutter",
-    "matchBrackets": "Match Brackets",
+    "matchBrackets": {
+      "label": "Match Brackets",
+      "description": "Matching bracket highlighting near the cursor."
+    },
     "prettier": {
       "label": "Prettier",
       "trailingComma": {
         "label": "Trailing Comma",
+        "description": "Trailing commas in multi-line structures when formatting.",
         "none": "None",
         "all": "All",
         "es5": "ES5"
       },
-      "semi": "Semi",
-      "singleQuote": "Single Quote"
+      "semi": {
+        "label": "Semi",
+        "description": "Semicolons at the end of every statement."
+      },
+      "singleQuote": {
+        "label": "Single Quote",
+        "description": "Single quotes instead of double quotes."
+      }
     }
   },
   "notesEditor": {
@@ -44,11 +67,11 @@
     },
     "fontFamily": {
       "label": "Text Font",
-      "description": "CSS font-family value. Use commas to specify fallbacks."
+      "description": "Text font for the notes editor. Use commas for fallbacks."
     },
     "codeFontFamily": {
       "label": "Monospace Font",
-      "description": "Font for inline code and fenced code blocks."
+      "description": "Monospace font for inline code and code blocks in the notes editor. Use commas for fallbacks."
     },
     "lineHeight": {
       "label": "Line Height",
@@ -63,11 +86,11 @@
     },
     "limitWidth": {
       "label": "Limit Width",
-      "description": "Constrain content to a comfortable reading width (700px)."
+      "description": "Maximum content width for comfortable reading (700px)."
     },
     "lineNumbers": {
       "label": "Line Numbers",
-      "description": "Show line numbers in the gutter. Only available in Raw mode."
+      "description": "Line numbers in the gutter. Only available in Raw mode."
     }
   },
   "appearance": {
@@ -79,7 +102,7 @@
       "themesDir": "Themes Directory",
       "openDir": "Open Themes Directory",
       "createTemplate": "Create Theme Template",
-      "dirDescription": "Place your JSON theme files in this folder.",
+      "dirDescription": "Directory for custom JSON theme files.",
       "light": "Light",
       "dark": "Dark",
       "system": "System"

src/main/i18n/locales/es_ES/preferences.json

@@ -12,28 +12,51 @@
   },
   "editor": {
     "label": "Editor",
-    "fontSize": "Tamaño de Fuente",
-    "fontFamily": "Familia de Fuente",
+    "fontSize": {
+      "label": "Tamaño de Fuente",
+      "description": "Base font size in pixels for the code editor."
+    },
+    "fontFamily": {
+      "label": "Familia de Fuente",
+      "description": "Monospace font for the code editor. Use commas for fallbacks."
+    },
     "wrap": {
       "label": "Ajuste",
+      "description": "Line wrapping to fit the editor width or allow horizontal scrolling.",
       "wordWrap": "Ajuste de Texto",
       "off": "Desactivado"
     },
-    "tabSize": "Tamaño de Tabulación",
+    "tabSize": {
+      "label": "Tamaño de Tabulación",
+      "description": "Number of spaces per tab character for indentation."
+    },
     "showInvisibles": "Mostrar Invisibles",
-    "highlightLine": "Resaltar Línea",
+    "highlightLine": {
+      "label": "Resaltar Línea",
+      "description": "Visual highlight on the line where the cursor is positioned."
+    },
     "highlightGutter": "Resaltar Margen",
-    "matchBrackets": "Emparejar Corchetes",
+    "matchBrackets": {
+      "label": "Emparejar Corchetes",
+      "description": "Matching bracket highlighting near the cursor."
+    },
     "prettier": {
       "label": "Prettier",
       "trailingComma": {
         "label": "Coma Final",
+        "description": "Trailing commas in multi-line structures when formatting.",
         "none": "Ninguna",
         "all": "Todas",
         "es5": "ES5"
       },
-      "semi": "Punto y Coma",
-      "singleQuote": "Comilla Simple"
+      "semi": {
+        "label": "Punto y Coma",
+        "description": "Semicolons at the end of every statement."
+      },
+      "singleQuote": {
+        "label": "Comilla Simple",
+        "description": "Single quotes instead of double quotes."
+      }
     }
   },
   "notesEditor": {

src/main/i18n/locales/fa_IR/preferences.json

@@ -12,28 +12,51 @@
   },
   "editor": {
     "label": "ویرایشگر",
-    "fontSize": "اندازه فونت",
-    "fontFamily": "خانواده فونت",
+    "fontSize": {
+      "label": "اندازه فونت",
+      "description": "Base font size in pixels for the code editor."
+    },
+    "fontFamily": {
+      "label": "خانواده فونت",
+      "description": "Monospace font for the code editor. Use commas for fallbacks."
+    },
     "wrap": {
       "label": "شکستن خط",
+      "description": "Line wrapping to fit the editor width or allow horizontal scrolling.",
       "wordWrap": "شکستن کلمه",
       "off": "خاموش"
     },
-    "tabSize": "اندازه تب",
+    "tabSize": {
+      "label": "اندازه تب",
+      "description": "Number of spaces per tab character for indentation."
+    },
     "showInvisibles": "نمایش نامرئی‌ها",
-    "highlightLine": "برجسته کردن خط",
+    "highlightLine": {
+      "label": "برجسته کردن خط",
+      "description": "Visual highlight on the line where the cursor is positioned."
+    },
     "highlightGutter": "برجسته کردن حاشیه",
-    "matchBrackets": "تطبیق پرانتزها",
+    "matchBrackets": {
+      "label": "تطبیق پرانتزها",
+      "description": "Matching bracket highlighting near the cursor."
+    },
     "prettier": {
       "label": "Prettier",
       "trailingComma": {
         "label": "کاما انتهایی",
+        "description": "Trailing commas in multi-line structures when formatting.",
         "none": "هیچ",
         "all": "همه",
         "es5": "ES5"
       },
-      "semi": "نقطه‌ویرگول",
-      "singleQuote": "تک کوتیشن"
+      "semi": {
+        "label": "نقطه‌ویرگول",
+        "description": "Semicolons at the end of every statement."
+      },
+      "singleQuote": {
+        "label": "تک کوتیشن",
+        "description": "Single quotes instead of double quotes."
+      }
     }
   },
   "notesEditor": {