Refactor docstrings for clarity and conciseness across multiple files

Author: iampopovich

py/selenium/webdriver/remote/errorhandler.py

@@ -143,8 +143,7 @@ class ErrorHandler:
     """Handles errors returned by the WebDriver server."""
 
     def check_response(self, response: dict[str, Any]) -> None:
-        """Checks that a JSON response from the WebDriver does not have an
-        error.
+        """Check that a JSON response from the WebDriver does not have an error.
 
         Args:
             response: The JSON response from the WebDriver server as a dictionary

py/selenium/webdriver/remote/file_detector.py

@@ -25,9 +25,7 @@
 
 
 class FileDetector(metaclass=ABCMeta):
-    """Used for identifying whether a sequence of chars represents the path to
-    a file.
-    """
+    """Identify whether a sequence of characters represents a file path."""
 
     @abstractmethod
     def is_local_file(self, *keys: AnyKey) -> Optional[str]:

py/selenium/webdriver/remote/remote_connection.py

@@ -224,9 +224,9 @@ def get_certificate_bundle_path(cls):
 
     @classmethod
     def set_certificate_bundle_path(cls, path):
-        """Set the path to the certificate bundle to verify connection to
-        command executor. Can also be set to None to disable certificate
-        validation.
+        """Set the path to the certificate bundle for verifying command executor connection.
+
+        Can also be set to None to disable certificate validation.
 
         Args:
             path: path of a .pem encoded certificate chain.

py/selenium/webdriver/remote/shadowroot.py

@@ -45,8 +45,7 @@ def id(self) -> str:
         return self._id
 
     def find_element(self, by: str = By.ID, value: str = None):
-        """Find an element inside a shadow root given a By strategy and
-        locator.
+        """Find an element inside a shadow root given a By strategy and locator.
 
         Args:
             by: The locating strategy to use. Default is `By.ID`. Supported values include:

py/selenium/webdriver/remote/switch_to.py

@@ -59,12 +59,11 @@ def default_content(self) -> None:
         self._driver.execute(Command.SWITCH_TO_FRAME, {"id": None})
 
     def frame(self, frame_reference: Union[str, int, WebElement]) -> None:
-        """Switches focus to the specified frame, by index, name, or
-        webelement.
+        """Switch focus to the specified frame by index, name, or element.
 
         Args:
-            frame_reference: The name of the window to switch to, an integer representing the index,
-                or a webelement that is an (i)frame to switch to.
+            frame_reference: The name of the frame to switch to, an integer representing the index,
+                or a WebElement that is an (i)frame to switch to.
 
         Example:
                 driver.switch_to.frame("frame_name")
@@ -95,8 +94,9 @@ def new_window(self, type_hint: Optional[str] = None) -> None:
         self._w3c_window(value["handle"])
 
     def parent_frame(self) -> None:
-        """Switches focus to the parent context. If the current context is the
-        top level browsing context, the context remains unchanged.
+        """Switch focus to the parent browsing context.
+
+        If the current context is already the top level browsing context, it remains unchanged.
 
         Example:
                 driver.switch_to.parent_frame()