From d5265cf5da036c39661509a86847b64325b594e4 Mon Sep 17 00:00:00 2001
From: Carlos Cordoba <ccordoba12@gmail.com>
Date: Wed, 26 Jul 2023 12:13:55 -0500
Subject: [PATCH] Improve descriptions for most plugins

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
---
 spyder/api/plugin_registration/_confpage.py               | 8 ++++----
 spyder/api/plugins/new_api.py                             | 2 +-
 .../spyder_boilerplate/spyder/plugin.py                   | 2 +-
 spyder/plugins/breakpoints/plugin.py                      | 2 +-
 spyder/plugins/completion/plugin.py                       | 6 +++---
 spyder/plugins/console/plugin.py                          | 2 +-
 spyder/plugins/debugger/plugin.py                         | 2 +-
 spyder/plugins/editor/plugin.py                           | 3 +--
 spyder/plugins/explorer/plugin.py                         | 2 +-
 spyder/plugins/externalconsole/plugin.py                  | 2 +-
 spyder/plugins/help/plugin.py                             | 3 +--
 spyder/plugins/history/plugin.py                          | 2 +-
 spyder/plugins/ipythonconsole/plugin.py                   | 3 +--
 spyder/plugins/maininterpreter/plugin.py                  | 4 ++--
 spyder/plugins/outlineexplorer/plugin.py                  | 4 +++-
 spyder/plugins/plots/plugin.py                            | 2 +-
 spyder/plugins/preferences/plugin.py                      | 2 +-
 spyder/plugins/pylint/plugin.py                           | 3 ++-
 spyder/plugins/run/plugin.py                              | 2 +-
 spyder/plugins/shortcuts/plugin.py                        | 2 +-
 spyder/plugins/statusbar/plugin.py                        | 2 +-
 spyder/plugins/switcher/plugin.py                         | 2 +-
 spyder/plugins/toolbar/plugin.py                          | 2 +-
 spyder/plugins/tours/plugin.py                            | 2 +-
 spyder/plugins/variableexplorer/plugin.py                 | 4 ++--
 spyder/plugins/workingdirectory/plugin.py                 | 3 +--
 26 files changed, 36 insertions(+), 37 deletions(-)

diff --git a/spyder/api/plugin_registration/_confpage.py b/spyder/api/plugin_registration/_confpage.py
index 520e1f9e920..fc0e4253ea1 100644
--- a/spyder/api/plugin_registration/_confpage.py
+++ b/spyder/api/plugin_registration/_confpage.py
@@ -23,9 +23,9 @@ def setup_page(self):
         self.plugins_checkboxes = {}
 
         header_label = QLabel(
-            _("Here you can turn on/off any internal or external Spyder "
-              "plugin to disable functionality that is not desired or to have "
-              "a lighter experience.")
+            _("Disable a Spyder plugin (external or built-in) to prevent it "
+              "from loading until re-enabled here, to simplify the interface "
+              "or in case it causes problems.")
         )
         header_label.setWordWrap(True)
 
@@ -53,7 +53,7 @@ def setup_page(self):
                     description=PluginClass.get_description(),
                     icon=PluginClass.get_icon(),
                     widget=cb,
-                    additional_info=_("Core plugin")
+                    additional_info=_("Built-in")
                 )
             )
 
diff --git a/spyder/api/plugins/new_api.py b/spyder/api/plugins/new_api.py
index a7a5bc38002..b62a41bce7a 100644
--- a/spyder/api/plugins/new_api.py
+++ b/spyder/api/plugins/new_api.py
@@ -766,7 +766,7 @@ def get_description():
 
         Notes
         -----
-        This method needs to be decorated with `staticmethod`
+        This method needs to be decorated with `staticmethod`.
         """
         raise NotImplementedError('A plugin description must be defined!')
 
diff --git a/spyder/app/tests/spyder-boilerplate/spyder_boilerplate/spyder/plugin.py b/spyder/app/tests/spyder-boilerplate/spyder_boilerplate/spyder/plugin.py
index 1cac57cd4c7..b1653a5299c 100644
--- a/spyder/app/tests/spyder-boilerplate/spyder_boilerplate/spyder/plugin.py
+++ b/spyder/app/tests/spyder-boilerplate/spyder_boilerplate/spyder/plugin.py
@@ -122,7 +122,7 @@ class SpyderBoilerplate(SpyderDockablePlugin):
     # ------------------------------------------------------------------------
     @staticmethod
     def get_name():
-        return "Spyder boilerplate plugin."
+        return "Spyder boilerplate plugin"
 
     @staticmethod
     def get_description():
diff --git a/spyder/plugins/breakpoints/plugin.py b/spyder/plugins/breakpoints/plugin.py
index 0f562892d46..a1d0c428f91 100644
--- a/spyder/plugins/breakpoints/plugin.py
+++ b/spyder/plugins/breakpoints/plugin.py
@@ -92,7 +92,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Manage code breakpoints in a unified pane.")
+        return _("Manage debugger breakpoints in a unified pane.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/completion/plugin.py b/spyder/plugins/completion/plugin.py
index 675b8d149d6..b76e7a51a28 100644
--- a/spyder/plugins/completion/plugin.py
+++ b/spyder/plugins/completion/plugin.py
@@ -266,9 +266,9 @@ def get_name() -> str:
 
     @staticmethod
     def get_description() -> str:
-        return _('This plugin is in charge of handling and dispatching, as '
-                 'well as of receiving the responses of completion, linting, '
-                 'symbols and folding requests sent to multiple providers.')
+        return _('Handle code completion, analysis, formatting, introspection, '
+                 'folding and more via the Language Server Protocol and other '
+                 'providers.')
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/console/plugin.py b/spyder/plugins/console/plugin.py
index e4278f48960..a7ad274a16b 100644
--- a/spyder/plugins/console/plugin.py
+++ b/spyder/plugins/console/plugin.py
@@ -88,7 +88,7 @@ def get_icon(cls):
 
     @staticmethod
     def get_description():
-        return _('Internal console running Spyder.')
+        return _('An internal Python console running Spyder itself.')
 
     def on_initialize(self):
         widget = self.get_widget()
diff --git a/spyder/plugins/debugger/plugin.py b/spyder/plugins/debugger/plugin.py
index e5ffb57589e..08af2562d21 100644
--- a/spyder/plugins/debugger/plugin.py
+++ b/spyder/plugins/debugger/plugin.py
@@ -58,7 +58,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _('Display and explore frames while debugging.')
+        return _('View, explore and navigate stack frames while debugging.')
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/editor/plugin.py b/spyder/plugins/editor/plugin.py
index 212c1e33fc0..1ec6542a6c6 100644
--- a/spyder/plugins/editor/plugin.py
+++ b/spyder/plugins/editor/plugin.py
@@ -652,8 +652,7 @@ def get_plugin_title():
     @staticmethod
     def get_description():
         return _(
-            "Edit Python, Markdown, Cython and many other types of plain text "
-            "files."
+            "Edit Python, Markdown, Cython and many other types of text files."
         )
 
     @classmethod
diff --git a/spyder/plugins/explorer/plugin.py b/spyder/plugins/explorer/plugin.py
index 49114fe723a..6dfe9de5db1 100644
--- a/spyder/plugins/explorer/plugin.py
+++ b/spyder/plugins/explorer/plugin.py
@@ -160,7 +160,7 @@ def get_name():
     @staticmethod
     def get_description():
         """Return the description of the explorer widget."""
-        return _("Explore filesystem in a tree view.")
+        return _("Explore your filesystem in a tree view.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/externalconsole/plugin.py b/spyder/plugins/externalconsole/plugin.py
index 79688b2e33b..23e386ee0e3 100644
--- a/spyder/plugins/externalconsole/plugin.py
+++ b/spyder/plugins/externalconsole/plugin.py
@@ -51,7 +51,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Run files in an external system terminal.")
+        return _("Run scripts in an external system terminal.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/help/plugin.py b/spyder/plugins/help/plugin.py
index c9e072c2892..07a84fb92aa 100644
--- a/spyder/plugins/help/plugin.py
+++ b/spyder/plugins/help/plugin.py
@@ -64,8 +64,7 @@ def get_name():
     @staticmethod
     def get_description():
         return _(
-            "Get documentation for objects used in the editor or IPython "
-            "console."
+            "Get documentation for objects in the Editor and IPython console."
         )
 
     @classmethod
diff --git a/spyder/plugins/history/plugin.py b/spyder/plugins/history/plugin.py
index 65f848641c1..607c600f20f 100644
--- a/spyder/plugins/history/plugin.py
+++ b/spyder/plugins/history/plugin.py
@@ -57,7 +57,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _('Provide command history for the IPython console.')
+        return _('View command history for the IPython console.')
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/ipythonconsole/plugin.py b/spyder/plugins/ipythonconsole/plugin.py
index 7de4e67db9f..d6da46de3fe 100644
--- a/spyder/plugins/ipythonconsole/plugin.py
+++ b/spyder/plugins/ipythonconsole/plugin.py
@@ -194,8 +194,7 @@ def get_name():
     @staticmethod
     def get_description():
         return _(
-            "Run Python files interactively in different ways (whole file, by "
-            "cells or selections)."
+            "Run Python files, cells, code and commands interactively."
         )
 
     @classmethod
diff --git a/spyder/plugins/maininterpreter/plugin.py b/spyder/plugins/maininterpreter/plugin.py
index b736413c535..abf1e4f69ef 100644
--- a/spyder/plugins/maininterpreter/plugin.py
+++ b/spyder/plugins/maininterpreter/plugin.py
@@ -47,8 +47,8 @@ def get_name():
     @staticmethod
     def get_description():
         return _(
-            "Manage default Python interpreter used by other plugins in "
-            "Spyder."
+            "Manage the default Python interpreter used to run, analyze and "
+            "profile your code in Spyder."
         )
 
     @classmethod
diff --git a/spyder/plugins/outlineexplorer/plugin.py b/spyder/plugins/outlineexplorer/plugin.py
index 02b0d949a6f..d01c8e3905d 100644
--- a/spyder/plugins/outlineexplorer/plugin.py
+++ b/spyder/plugins/outlineexplorer/plugin.py
@@ -36,7 +36,9 @@ def get_name() -> str:
     @staticmethod
     def get_description() -> str:
         """Return the description of the outline explorer widget."""
-        return _("Explore functions, classes and methods in the current file.")
+        return _("Explore functions, classes and methods in open files. Note "
+                 "that if you disable the 'Completions and linting' plugin, "
+                 "this one won't work.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/plots/plugin.py b/spyder/plugins/plots/plugin.py
index 97a97dce4cc..22e721e4532 100644
--- a/spyder/plugins/plots/plugin.py
+++ b/spyder/plugins/plots/plugin.py
@@ -35,7 +35,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _('Display, explore and save console generated plots.')
+        return _('View, browse and save generated figures.')
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/preferences/plugin.py b/spyder/plugins/preferences/plugin.py
index 9428558fb2e..f6f4e8c32f0 100644
--- a/spyder/plugins/preferences/plugin.py
+++ b/spyder/plugins/preferences/plugin.py
@@ -268,7 +268,7 @@ def get_name() -> str:
 
     @staticmethod
     def get_description() -> str:
-        return _("Manage Spyder's main preferences dialog.")
+        return _("Manage Spyder's preferences.")
 
     @classmethod
     def get_icon(cls) -> QIcon:
diff --git a/spyder/plugins/pylint/plugin.py b/spyder/plugins/pylint/plugin.py
index ffe6bbbf0ca..d15c5033577 100644
--- a/spyder/plugins/pylint/plugin.py
+++ b/spyder/plugins/pylint/plugin.py
@@ -69,7 +69,8 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Display static and real time code analysis results.")
+        return _("Analyze code and view the results from both static and "
+                 "real-time analysis.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/run/plugin.py b/spyder/plugins/run/plugin.py
index 5f233c1c22c..d5fc445421a 100644
--- a/spyder/plugins/run/plugin.py
+++ b/spyder/plugins/run/plugin.py
@@ -70,7 +70,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Manage run configuration to execute files.")
+        return _("Manage run configuration for executing files.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/shortcuts/plugin.py b/spyder/plugins/shortcuts/plugin.py
index 57bb10d7f6d..53b5fe537af 100644
--- a/spyder/plugins/shortcuts/plugin.py
+++ b/spyder/plugins/shortcuts/plugin.py
@@ -65,7 +65,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Manage application, widget and actions shortcuts.")
+        return _("Manage application, pane and actions shortcuts.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/statusbar/plugin.py b/spyder/plugins/statusbar/plugin.py
index 5b65649af35..247a93da454 100644
--- a/spyder/plugins/statusbar/plugin.py
+++ b/spyder/plugins/statusbar/plugin.py
@@ -59,7 +59,7 @@ def get_icon(cls):
 
     @staticmethod
     def get_description():
-        return _("Manage main window status bar.")
+        return _("Display the main window status bar.")
 
     def on_initialize(self):
         # --- Status widgets
diff --git a/spyder/plugins/switcher/plugin.py b/spyder/plugins/switcher/plugin.py
index f9240012210..160a68fedde 100644
--- a/spyder/plugins/switcher/plugin.py
+++ b/spyder/plugins/switcher/plugin.py
@@ -110,7 +110,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Display and manage a multi-purpose switcher.")
+        return _("Quickly switch between files and other items.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/toolbar/plugin.py b/spyder/plugins/toolbar/plugin.py
index 02867927ac7..65f4e5dbe59 100644
--- a/spyder/plugins/toolbar/plugin.py
+++ b/spyder/plugins/toolbar/plugin.py
@@ -46,7 +46,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _('Application toolbars management.')
+        return _('Manage application toolbars.')
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/tours/plugin.py b/spyder/plugins/tours/plugin.py
index 1dede045a20..31bac84ac8c 100644
--- a/spyder/plugins/tours/plugin.py
+++ b/spyder/plugins/tours/plugin.py
@@ -42,7 +42,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Provide interactive tours for the Spyder interface.")
+        return _("Provide interactive tours of the Spyder interface.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/variableexplorer/plugin.py b/spyder/plugins/variableexplorer/plugin.py
index 48b17ca2bf0..279a5db216e 100644
--- a/spyder/plugins/variableexplorer/plugin.py
+++ b/spyder/plugins/variableexplorer/plugin.py
@@ -41,8 +41,8 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Display, explore, load and save global variables generated "
-                 "after execution")
+        return _("Explore, edit, save and load the lists, arrays, dataframes "
+                 "and other global variables generated by running your code.")
 
     @classmethod
     def get_icon(cls):
diff --git a/spyder/plugins/workingdirectory/plugin.py b/spyder/plugins/workingdirectory/plugin.py
index 96e8315f4ce..96de906168c 100644
--- a/spyder/plugins/workingdirectory/plugin.py
+++ b/spyder/plugins/workingdirectory/plugin.py
@@ -63,8 +63,7 @@ def get_name():
 
     @staticmethod
     def get_description():
-        return _("Display and manage the current working directory used by "
-                 "other plugins in Spyder.")
+        return _("Manage the current working directory used in Spyder.")
 
     @classmethod
     def get_icon(cls):