From 06be778e9819e7e76c5310759832686c3feb2f9c Mon Sep 17 00:00:00 2001
From: Ramon Perez <ramonpzg@protonmail.com>
Date: Wed, 18 Jun 2025 02:17:15 +1000
Subject: [PATCH] improved wording in UI elements (#5323)

---
 web-app/src/locales/en/settings.json          |  8 ++---
 web-app/src/routes/settings/appearance.tsx    | 24 +++++++--------
 web-app/src/routes/settings/general.tsx       | 30 ++++++++++---------
 web-app/src/routes/settings/hardware.tsx      |  2 +-
 web-app/src/routes/settings/https-proxy.tsx   | 16 +++++-----
 .../src/routes/settings/local-api-server.tsx  | 18 +++++------
 web-app/src/routes/settings/privacy.tsx       | 18 +++++------
 web-app/src/routes/settings/shortcuts.tsx     | 14 ++++-----
 8 files changed, 65 insertions(+), 65 deletions(-)

diff --git a/web-app/src/locales/en/settings.json b/web-app/src/locales/en/settings.json
index 67edc9c8b..0422c28ca 100644
--- a/web-app/src/locales/en/settings.json
+++ b/web-app/src/locales/en/settings.json
@@ -5,15 +5,15 @@
     },
     "dataFolder": {
       "appData": "App Data",
-      "appDataDesc": "Default location for messages and other user data",
+      "appDataDesc": "Default location for messages and other user data.",
       "appLogs": "App Logs",
-      "appLogsDesc": "Default location App Logs"
+      "appLogsDesc": "Default location App Logs."
     },
     "others": {
       "spellCheck": "Spell Check",
-      "spellCheckDesc": "Turn on to enable spell check chat input.",
+      "spellCheckDesc": "Enable spell check for your threads.",
       "resetFactory": "Reset To Factory Settings",
-      "resetFactoryDesc": "Restore application to its initial state, erasing all models and chat history. This action is irreversible and recommended only if the application is corrupted"
+      "resetFactoryDesc": "Restore application to its initial state, erasing all models and chat history. This action is irreversible and recommended only if the application is corrupted."
     }
   }
 }
diff --git a/web-app/src/routes/settings/appearance.tsx b/web-app/src/routes/settings/appearance.tsx
index 21b99c73e..cd3306080 100644
--- a/web-app/src/routes/settings/appearance.tsx
+++ b/web-app/src/routes/settings/appearance.tsx
@@ -43,43 +43,43 @@ function Appareances() {
             <Card title="Appearance">
               <CardItem
                 title="Theme"
-                description="Native appearance for consistent theming across OS UI elements"
+                description="Match the OS theme."
                 actions={<ThemeSwitcher />}
               />
               <CardItem
                 title="Font Size"
-                description="Adjust the size of text across the app"
+                description="Adjust the app's font size."
                 actions={<FontSizeSwitcher />}
               />
 
               <CardItem
                 title="Window Background"
-                description="Choose the App window color"
+                description="Set the app window's background color."
                 actions={<ColorPickerAppBgColor />}
               />
               <CardItem
                 title="App Main View"
-                description="Sets the background color for the main content area"
+                description="Set the main content area's background color."
                 actions={<ColorPickerAppMainView />}
               />
               <CardItem
                 title="Primary"
-                description="Controls the primary color used for components"
+                description="Set the primary color for UI components."
                 actions={<ColorPickerAppPrimaryColor />}
               />
               <CardItem
                 title="Accent"
-                description="Controls the accent color used for highlights"
+                description="Set the accent color for UI highlights."
                 actions={<ColorPickerAppAccentColor />}
               />
               <CardItem
                 title="Destructive"
-                description="Controls the color used for destructive actions"
+                description="Set the color for destructive actions."
                 actions={<ColorPickerAppDestructiveColor />}
               />
               <CardItem
                 title="Reset to Default"
-                description="Reset all colors to their default values"
+                description="Reset all appearance settings to default."
                 actions={
                   <Button
                     variant="destructive"
@@ -103,7 +103,7 @@ function Appareances() {
             <Card>
               <CardItem
                 title="Chat Width"
-                description="Choose the width of the chat area to customize your conversation view."
+                description="Customize the width of the chat view."
               />
               <ChatWidthSwitcher />
             </Card>
@@ -112,18 +112,18 @@ function Appareances() {
             <Card>
               <CardItem
                 title="Code Block"
-                description="Choose the style for code block syntax highlighting"
+                description="Choose a syntax highlighting style."
                 actions={<CodeBlockStyleSwitcher />}
               />
               <CodeBlockExample />
               <CardItem
                 title="Show Line Numbers"
-                description="Toggle line numbers in code blocks"
+                description="Display line numbers in code blocks."
                 actions={<LineNumbersSwitcher />}
               />
               <CardItem
                 title="Reset Code Block Style"
-                description="Reset code block style to default"
+                description="Reset code block style to default."
                 actions={
                   <Button
                     variant="destructive"
diff --git a/web-app/src/routes/settings/general.tsx b/web-app/src/routes/settings/general.tsx
index 33eafc341..cfdd4f298 100644
--- a/web-app/src/routes/settings/general.tsx
+++ b/web-app/src/routes/settings/general.tsx
@@ -220,7 +220,7 @@ function General() {
               />
               <CardItem
                 title="Check for Updates"
-                description="Check if a newer version of Jan is available"
+                description="Check if a newer version of Jan is available."
                 actions={
                   <Button
                     variant="link"
@@ -327,7 +327,7 @@ function General() {
                 title={t('settings.dataFolder.appLogs', {
                   ns: 'settings',
                 })}
-                description="View detailed logs of the App"
+                description="View detailed logs of the App."
                 actions={
                   <div className="flex items-center gap-2">
                     <Button
@@ -408,9 +408,9 @@ function General() {
                       <DialogHeader>
                         <DialogTitle>Factory Reset</DialogTitle>
                         <DialogDescription>
-                          Are you sure you want to reset the app to factory
-                          settings? This action is irreversible and recommended
-                          only if the application is corrupted.
+                          This will reset all app settings to their defaults.
+                          This can't be undone. We only recommend this if the
+                          app is corrupted.
                         </DialogDescription>
                         <DialogFooter className="mt-2 flex items-center">
                           <DialogClose asChild>
@@ -442,7 +442,7 @@ function General() {
             <Card title="Resources">
               <CardItem
                 title="Documentation"
-                description="Learn how to use Jan and explore its features"
+                description="Learn how to use Jan and explore its features."
                 actions={
                   <a
                     href="https://jan.ai/docs"
@@ -458,7 +458,7 @@ function General() {
               />
               <CardItem
                 title="Release Notes"
-                description="See what's new in the latest version"
+                description="See what's new in the latest version of Jan."
                 actions={
                   <a
                     href="https://github.com/menloresearch/jan/releases"
@@ -478,7 +478,7 @@ function General() {
             <Card title="Community">
               <CardItem
                 title="GitHub"
-                description="Contribute to Jan's development"
+                description="Contribute to Jan's development."
                 actions={
                   <a
                     href="https://github.com/menloresearch/jan"
@@ -496,7 +496,7 @@ function General() {
               />
               <CardItem
                 title="Discord"
-                description="Join our community for support and discussions"
+                description="Join our community for support and discussions."
                 actions={
                   <a
                     href="https://discord.com/invite/FTk2MvZwJH"
@@ -518,7 +518,7 @@ function General() {
             <Card title="Support">
               <CardItem
                 title="Report an Issue"
-                description="Found a bug? Let us know on GitHub"
+                description="Found a bug? Help us out by filing an issue on GitHub."
                 actions={
                   <a
                     href="https://github.com/menloresearch/jan/issues/new"
@@ -540,12 +540,14 @@ function General() {
                 description={
                   <div className="text-main-view-fg/70 -mt-2">
                     <p>
-                      Jan is built with ❤️ by the Jan team and contributors from
-                      around the world.
+                      Jan is built with ❤️ by the{' '}
+                      <a href="https://menlo.ai" target="_blank">
+                        Menlo Team.
+                      </a>
                     </p>
                     <p className="mt-2">
-                      Special thanks to all our open-source dependencies and the
-                      amazing AI community.
+                      Special thanks to our open-source dependencies—especially
+                      llama.cpp and Tauri—and to our amazing AI community.
                     </p>
                   </div>
                 }
diff --git a/web-app/src/routes/settings/hardware.tsx b/web-app/src/routes/settings/hardware.tsx
index 53de1f9b3..ab42a15f9 100644
--- a/web-app/src/routes/settings/hardware.tsx
+++ b/web-app/src/routes/settings/hardware.tsx
@@ -352,7 +352,7 @@ function Hardware() {
               <Card title="Vulkan">
                 <CardItem
                   title="Enable Vulkan"
-                  description="Enable Vulkan API for GPU acceleration"
+                  description="Use Vulkan API for GPU acceleration."
                   actions={
                     <div className="flex items-center gap-4">
                       <Switch
diff --git a/web-app/src/routes/settings/https-proxy.tsx b/web-app/src/routes/settings/https-proxy.tsx
index 2d8f1b3ba..f510eefa9 100644
--- a/web-app/src/routes/settings/https-proxy.tsx
+++ b/web-app/src/routes/settings/https-proxy.tsx
@@ -129,7 +129,7 @@ function HTTPSProxy() {
                 className="block"
                 description={
                   <div className="space-y-2">
-                    <p>URL and port of your proxy server.</p>
+                    <p>The URL and port of your proxy server.</p>
                     <Input
                       className="w-full"
                       placeholder="http://<user>:<password>@<domain or IP>:<port>"
@@ -144,7 +144,7 @@ function HTTPSProxy() {
                 className="block"
                 description={
                   <div className="space-y-2">
-                    <p>Credentials for your proxy server (if required).</p>
+                    <p>Credentials for the proxy server, if required.</p>
                     <div className="flex gap-2">
                       <Input
                         placeholder="Username"
@@ -181,7 +181,7 @@ function HTTPSProxy() {
                 className="block"
                 description={
                   <div className="space-y-2">
-                    <p>List of hosts that should bypass the proxy.</p>
+                    <p>A comma-separated list of hosts to bypass the proxy.</p>
                     <Input
                       placeholder="localhost, 127.0.0.1"
                       value={noProxy}
@@ -196,7 +196,7 @@ function HTTPSProxy() {
             <Card title="SSL Verification">
               <CardItem
                 title="Ignore SSL Certificates"
-                description="Allow self-signed or unverified certificates (may be required for certain proxies). Enable this reduces security. Only use this if you trust your proxy server."
+                description="Allow self-signed or unverified certificates. This may be required for some proxies but reduces security. Only enable if you trust your proxy."
                 actions={
                   <Switch
                     checked={proxyIgnoreSSL}
@@ -206,7 +206,7 @@ function HTTPSProxy() {
               />
               <CardItem
                 title="Proxy SSL"
-                description="Validate SSL certificate when connecting to the proxy server."
+                description="Validate the SSL certificate when connecting to the proxy."
                 actions={
                   <Switch
                     checked={verifyProxySSL}
@@ -216,7 +216,7 @@ function HTTPSProxy() {
               />
               <CardItem
                 title="Proxy Host SSL"
-                description="Validate SSL certificate of the proxy server host."
+                description="Validate the SSL certificate of the proxy's host."
                 actions={
                   <Switch
                     checked={verifyProxyHostSSL}
@@ -228,7 +228,7 @@ function HTTPSProxy() {
               />
               <CardItem
                 title="Peer SSL"
-                description="Validate SSL certificate of the peer connections."
+                description="Validate the SSL certificates of peer connections."
                 actions={
                   <Switch
                     checked={verifyPeerSSL}
@@ -238,7 +238,7 @@ function HTTPSProxy() {
               />
               <CardItem
                 title="Host SSL"
-                description="Validate SSL certificate of destination hosts."
+                description="Validate the SSL certificates of destination hosts."
                 actions={
                   <Switch
                     checked={verifyHostSSL}
diff --git a/web-app/src/routes/settings/local-api-server.tsx b/web-app/src/routes/settings/local-api-server.tsx
index 3bbbaf176..dd7561be5 100644
--- a/web-app/src/routes/settings/local-api-server.tsx
+++ b/web-app/src/routes/settings/local-api-server.tsx
@@ -148,7 +148,7 @@ function LocalAPIServer() {
                   <div className="w-full space-y-2">
                     <h1 className="text-base font-medium">Local API Server</h1>
                     <p className="text-main-view-fg/70 mb-2">
-                      Start an OpenAI-compatible local HTTP server.
+                      Run an OpenAI-compatible server locally.
                     </p>
                   </div>
                   <div className="flex items-center gap-2">
@@ -165,7 +165,7 @@ function LocalAPIServer() {
             >
               <CardItem
                 title="Server Logs"
-                description="View detailed logs of the local API server"
+                description="View detailed logs of the local API server."
                 actions={
                   <Button
                     variant="link"
@@ -187,7 +187,7 @@ function LocalAPIServer() {
             <Card title="Server Configuration">
               <CardItem
                 title="Server Host"
-                description="Choose between 127.0.0.1 or 0.0.0.0"
+                description="Network address for the server."
                 className={cn(
                   isServerRunning && 'opacity-50 pointer-events-none'
                 )}
@@ -195,7 +195,7 @@ function LocalAPIServer() {
               />
               <CardItem
                 title="Server Port"
-                description="Set the port number for the API server"
+                description="Port number for the API server."
                 className={cn(
                   isServerRunning && 'opacity-50 pointer-events-none'
                 )}
@@ -203,7 +203,7 @@ function LocalAPIServer() {
               />
               <CardItem
                 title="API Prefix"
-                description="Set the API endpoint prefix"
+                description="Path prefix for API endpoints."
                 className={cn(
                   isServerRunning && 'opacity-50 pointer-events-none'
                 )}
@@ -211,7 +211,7 @@ function LocalAPIServer() {
               />
               <CardItem
                 title="API Key"
-                description="Authenticate requests with an API key"
+                description="Authenticate requests with an API key."
                 className={cn(
                   isServerRunning && 'opacity-50 pointer-events-none',
                   isApiKeyEmpty && showApiKeyError && 'pb-6'
@@ -225,7 +225,7 @@ function LocalAPIServer() {
               />
               <CardItem
                 title="Trusted Hosts"
-                description="Add trusted hosts that can access the API server"
+                description="Hosts allowed to access the server, separated by commas."
                 className={cn(
                   isServerRunning && 'opacity-50 pointer-events-none'
                 )}
@@ -237,7 +237,7 @@ function LocalAPIServer() {
             <Card title="Advanced Settings">
               <CardItem
                 title="Cross-Origin Resource Sharing (CORS)"
-                description="Allow requests from different origins to access the API"
+                description="Allow cross-origin requests to the API server."
                 className={cn(
                   isServerRunning && 'opacity-50 pointer-events-none'
                 )}
@@ -250,7 +250,7 @@ function LocalAPIServer() {
               />
               <CardItem
                 title="Verbose Server Logs"
-                description="Enable detailed logging for debugging purposes"
+                description="Enable detailed server logs for debugging."
                 className={cn(
                   isServerRunning && 'opacity-50 pointer-events-none'
                 )}
diff --git a/web-app/src/routes/settings/privacy.tsx b/web-app/src/routes/settings/privacy.tsx
index 27b21e562..0958c2019 100644
--- a/web-app/src/routes/settings/privacy.tsx
+++ b/web-app/src/routes/settings/privacy.tsx
@@ -52,9 +52,9 @@ function Privacy() {
                 title="Help us improve"
                 description={
                   <p>
-                    By opting in, you help us make Jan better by sharing
-                    anonymous data, like feature usage and user counts. Your
-                    chats and personal information are never collected.
+                    To help us improve Jan, you can share anonymous data like
+                    feature usage and user counts. We never collect your chats
+                    or personal information.
                   </p>
                 }
                 align="start"
@@ -63,17 +63,15 @@ function Privacy() {
                 description={
                   <div className="text-main-view-fg/90">
                     <p>
-                      We prioritize your control over your data. Learn more
-                      about our Privacy Policy.
+                      You have full control over your data. Learn more in our
+                      Privacy Policy.
                     </p>
                     <p className="my-1">
-                      To make Jan better, we need to understand how it’s used -
-                      but only if you choose to help. You can change your Jan
-                      Analytics settings anytime.
+                      To improve Jan, we need to understand how it’s used—but
+                      only with your help. You can change this setting anytime.
                     </p>
                     <p>
-                      Your choice to opt-in or out doesn't change our core
-                      privacy promises:
+                      Your choice here won’t change our core privacy promises:
                     </p>
                     <ul className="list-disc pl-4 space-y-1 mt-4">
                       <li className="font-medium">Your chats are never read</li>
diff --git a/web-app/src/routes/settings/shortcuts.tsx b/web-app/src/routes/settings/shortcuts.tsx
index 2d46ad7c2..2aac82447 100644
--- a/web-app/src/routes/settings/shortcuts.tsx
+++ b/web-app/src/routes/settings/shortcuts.tsx
@@ -27,7 +27,7 @@ function Shortcuts() {
             <Card title="Application">
               <CardItem
                 title="New Chat"
-                description="Create a new chat conversation"
+                description="Create a new chat."
                 actions={
                   <div className="flex items-center justify-center px-3 py-1 bg-main-view-fg/5 rounded-md">
                     <span className="font-medium">
@@ -38,7 +38,7 @@ function Shortcuts() {
               />
               <CardItem
                 title="Toggle Sidebar"
-                description="Show or hide the sidebar"
+                description="Show or hide the sidebar."
                 actions={
                   <div className="flex items-center justify-center px-3 py-1 bg-main-view-fg/5 rounded-md">
                     <span className="font-medium">
@@ -49,7 +49,7 @@ function Shortcuts() {
               />
               <CardItem
                 title="Zoom In"
-                description="Increase the zoom level"
+                description="Increase the zoom level."
                 actions={
                   <div className="flex items-center justify-center px-3 py-1 bg-main-view-fg/5 rounded-md">
                     <span className="font-medium">
@@ -60,7 +60,7 @@ function Shortcuts() {
               />
               <CardItem
                 title="Zoom Out"
-                description="Decrease the zoom level"
+                description="Decrease the zoom level."
                 actions={
                   <div className="flex items-center justify-center px-3 py-1 bg-main-view-fg/5 rounded-md">
                     <span className="font-medium">
@@ -75,7 +75,7 @@ function Shortcuts() {
             <Card title="Chat">
               <CardItem
                 title="Send Message"
-                description="Send the current message"
+                description="Send the current message."
                 actions={
                   <div className="flex items-center justify-center px-3 py-1 bg-main-view-fg/5 rounded-md">
                     <span className="font-medium">Enter</span>
@@ -84,7 +84,7 @@ function Shortcuts() {
               />
               <CardItem
                 title="New Line"
-                description="Insert a new line in the message"
+                description="Insert a new line."
                 actions={
                   <div className="flex items-center justify-center px-3 py-1 bg-main-view-fg/5 rounded-md">
                     <span className="font-medium">Shift + Enter</span>
@@ -97,7 +97,7 @@ function Shortcuts() {
             <Card title="Navigation">
               <CardItem
                 title="Go to Settings"
-                description="Open the settings page"
+                description="Open settings."
                 actions={
                   <div className="flex items-center justify-center px-3 py-1 bg-main-view-fg/5 rounded-md">
                     <span className="font-medium">