Merge branch 'trunk' into final-python-pagesize-support

Author: yvsvarma

.github/workflows/update-documentation.yml

@@ -140,10 +140,6 @@ jobs:
         run: |
           git config --local user.email "[email protected]"
           git config --local user.name "Selenium CI Bot"
-      - name: Install specific version of DocFX tool
-        #  Pinning to 2.75.3 to avoid breaking changes in newer versions
-        #  See https://github.com/dotnet/docfx/issues/9855
-        run: dotnet tool install --global --version 2.75.3 docfx
       - name: Update Documentation
         if: needs.determine-language.outputs.language == 'all' || needs.determine-language.outputs.language == 'dotnet'
         run: ./go dotnet:docs

MODULE.bazel

@@ -93,7 +93,7 @@ register_toolchains("@dotnet_toolchains//:all")
 oci = use_extension("@rules_oci//oci:extensions.bzl", "oci")
 oci.pull(
     name = "java_image_base",
-    digest = "sha256:161a1d97d592b3f1919801578c3a47c8e932071168a96267698f4b669c24c76d",
+    digest = "sha256:1df9f3e6a2de0544dd04f1840aa811d334045c9126f9e93d8da45448061ad51e",
     image = "gcr.io/distroless/java17",
 )
 oci.pull(

Rakefile

@@ -777,10 +777,9 @@ namespace :dotnet do
   task :docs, [:skip_update] do |_task, arguments|
     FileUtils.rm_rf('build/docs/api/dotnet/')
     begin
-      # Pinning to 2.75.3 to avoid breaking changes in newer versions
-      # See https://github.com/dotnet/docfx/issues/9855
+      # Pinning to 2.78.2 to avoid breaking changes in newer versions
       sh 'dotnet tool uninstall --global docfx || true'
-      sh 'dotnet tool install --global --version 2.75.3 docfx'
+      sh 'dotnet tool install --global --version 2.78.2 docfx'
       # sh 'dotnet tool update -g docfx'
     rescue StandardError
       puts 'Please ensure that .NET SDK is installed.'

dotnet/docs/docfx.json

@@ -11,7 +11,7 @@
       ],
       "dest": "webdriver",
       "namespaceLayout": "nested",
-      "outputFormat": "apiPage"
+      //"outputFormat": "apiPage" // "apiPage" generation with errors
     },
     {
       "src": [
@@ -24,9 +24,8 @@
       ],
       "dest": "support",
       "namespaceLayout": "nested",
-      "outputFormat": "apiPage"
+      //"outputFormat": "apiPage" // "apiPage" generation with errors
     }
-
   ],
   "build": {
     "content": [

py/selenium/webdriver/common/by.py

@@ -22,7 +22,58 @@
 
 
 class By:
-    """Set of supported locator strategies."""
+    """Set of supported locator strategies.
+
+    ID:
+    --
+    Select the element by its ID.
+
+    >>> element = driver.find_element(By.ID, 'myElement')
+
+    XPATH:
+    ------
+    Select the element via XPATH.
+        - absolute path
+        - relative path
+
+    >>> element = driver.find_element(By.XPATH, '//html/body/div')
+
+    LINK_TEXT:
+    ----------
+    Select the link element having the exact text.
+
+    >>> element = driver.find_element(By.LINK_TEXT, 'myLink')
+
+    PARTIAL_LINK_TEXT:
+    ------------------
+    Select the link element having the partial text.
+
+    >>> element = driver.find_element(By.PARTIAL_LINK_TEXT, 'my')
+
+    NAME:
+    ----
+    Select the element by its name attribute.
+
+    >>> element = driver.find_element(By.NAME, 'myElement')
+
+    TAG_NAME:
+    --------
+    Select the element by its tag name.
+
+    >>> element = driver.find_element(By.TAG_NAME, 'div')
+
+    CLASS_NAME:
+    ----------
+    Select the element by its class name.
+
+    >>> element = driver.find_element(By.CLASS_NAME, 'myElement')
+
+    CSS_SELECTOR:
+    -------------
+    Select the element by its CSS selector.
+
+    >>> element = driver.find_element(By.CSS_SELECTOR, 'div.myElement')
+    """
 
     ID = "id"
     XPATH = "xpath"