[py] Update docstrings

Author: cgoldberg

py/selenium/webdriver/remote/server.py

@@ -27,9 +27,12 @@
 
 
 class Server:
-    """Manage the Selenium Remote (Grid) Server.
+    """Manage a Selenium Grid (Remote) Server in standalone mode.
 
-    Selenium Manager will detect the server location and download it if necessary, unless an existing server path is specified.
+    This class contains functionality for downloading the server and starting/stopping it.
+
+    For more information on Selenium Grid, see:
+        - https://www.selenium.dev/documentation/grid/getting_started/
 
     Parameters:
     -----------
@@ -89,8 +92,11 @@ def _wait_for_server(self, timeout=10):
         return False
 
     def start(self):
-        """Start the server."""
+        """Start the server.
 
+        Selenium Manager will detect the server location and download it if necessary,
+        unless an existing server path was specified.
+        """
         if self.path is None:
             selenium_manager = SeleniumManager()
             args = ["--grid"]

py/test/unit/selenium/webdriver/remote/remote_server_tests.py

@@ -28,23 +28,27 @@ def test_server_with_bad_path():
     with pytest.raises(OSError, match=re.escape(msg)):
         Server(path=path)
 
+
 def test_server_with_invalid_version():
     versions = ("0.0", "invalid")
     for version in versions:
         msg = f"Server.__init__() got an invalid version: '{version}'"
         with pytest.raises(TypeError, match=re.escape(msg)):
             Server(version=version)
 
+
 def test_server_with_invalid_port():
     port = "invalid"
     msg = f"Server.__init__() got an invalid port: '{port}'"
     with pytest.raises(TypeError, match=re.escape(msg)):
         Server(port=port)
 
+
 def test_server_with_port_out_of_range():
     with pytest.raises(ValueError, match="port must be 0-65535"):
         Server(port=99999)
 
+
 def test_stopping_server_thats_not_running():
     server = Server()
     with pytest.raises(RuntimeError, match="Selenium server isn't running"):