fine-tuning of changes

Author: Lupin3000

serial_plugin/serial_base.py

@@ -11,14 +11,14 @@
 
 class SerialBase:
     """
-    Manages a MicroPython serial connection and REPL modes.
+    Manages a MicroPython serial connection and offers REPL communication modes.
     """
 
     def __init__(self, port: str, baudrate: int = SERIAL_RATE, timeout: int = 2):
         """
-        Initializes a serial connection with the provided port settings.
+        Initializes a serial connection with the provided usb device port settings.
 
-        :param port: The serial port to connect to.
+        :param port: The serial device port to connect to.
         :type port: str
         :param baudrate: The baud rate for the connection, which determines data transmission speed.
         :type baudrate: int, optional

serial_plugin/serial_get_file_structure.py

@@ -8,10 +8,11 @@
 
 class FileStructure(SerialBase):
     """
-    Represents a utility for interacting with a MicroPython device to fetch and manage
-    a tree structure of the file system over a serial connection.
+    Represents a utility for interacting with a device to fetch and manage
+    the file structure of MicroPython firmware flashed device over a
+    serial connection.
 
-    :ivar _TREE_CODE: The Python code to generate the tree structure.
+    :ivar _TREE_CODE: The MicroPython REPL code to generate the tree structure.
     """
     _TREE_CODE = (
         "import os\n"

serial_plugin/serial_get_version.py

@@ -7,8 +7,9 @@
 
 class Version(SerialBase):
     """
-    Represents a utility for interacting with a MicroPython device to fetch the
-    current Micropython version information over a serial connection.
+    Represents a utility for interacting with a device to  fetch the
+    current Micropython version of MicroPython firmware flashed device
+    over a serial connection.
     """
 
     @staticmethod

ui/__init__.py

@@ -1,15 +1,17 @@
-from .firmware_studio import CommandRunner
 from .base_ui import BaseUI
-from .frame_search_device import FrameSearchDevice
+from .firmware_studio import CommandRunner
+from .frame_console import FrameConsole
 from .frame_device_information import FrameDeviceInformation
 from .frame_erase_device import FrameEraseDevice
 from .frame_firmware_flash import FrameFirmwareFlash
-from .frame_console import FrameConsole
+from .frame_search_device import FrameSearchDevice
+
 
-__all__ = ["CommandRunner",
-           "BaseUI",
+__all__ = ["BaseUI",
+           "CommandRunner",
+            "FrameConsole",
            "FrameSearchDevice",
            "FrameDeviceInformation",
            "FrameEraseDevice",
-           "FrameFirmwareFlash",
-           "FrameConsole"]
+           "FrameFirmwareFlash"
+           ]

ui/base_ui.py

@@ -12,7 +12,8 @@
 class BaseUI(CTk):
     """
     BaseUI is responsible for the overall layout and initialization of the graphical
-    user interface (GUI). It manages the creation of UI frames.
+    user interface (GUI). It manages the creation and configuration OS detection,
+    Default Window settings and grid layout.
     """
 
     def __init__(self):

ui/firmware_studio.py

@@ -24,7 +24,12 @@
 
 class MicroPythonFirmwareStudio(BaseUI):
     """
-    A class representing the MicroPython Firmware Studio GUI via CTkinter.
+    A GUI class to manage ESP device configuration and firmware flashing.
+
+    Provides an interface to connect, configure, and flash firmware for ESP devices.
+    Includes options to toggle expert mode and interact with device-specific details.
+
+    The class integrates multiple frames, to guide users through ESP device communication.
     """
 
     def __init__(self):