[dotnet] Improve nuget packages metadata

dotnet/src/support/BUILD.bazel

@@ -51,7 +51,7 @@ csharp_library(
 nuget_pack(
     name = "support",
     files = {
-        "//common/images:selenium_logo_small.png": "images/icon.png",
+        "//common/images:selenium_logo_small.png": "icon.png",
     },
     id = "Selenium.Support",
     libs = {
@@ -91,7 +91,7 @@ csharp_library(
 nuget_pack(
     name = "support-strongnamed",
     files = {
-        "//common/images:selenium_logo_small.png": "images/icon.png",
+        "//common/images:selenium_logo_small.png": "icon.png",
     },
     id = "Selenium.Support.StrongNamed",
     libs = {

dotnet/src/support/WebDriver.Support.StrongNamed.nuspec

@@ -4,27 +4,23 @@
     <id>$packageid$</id>
     <version>$version$</version>
     <authors>Selenium Committers</authors>
-    <copyright>Copyright © 2020 Software Freedom Conservancy</copyright>
+    <copyright>Copyright © 2023 Software Freedom Conservancy</copyright>
     <owners>selenium</owners>
     <title>WebDriver Support</title>
     <requireLicenseAcceptance>false</requireLicenseAcceptance>
     <summary>Provides support classes for Selenium WebDriver</summary>
     <description>
-      Selenium is a set of different software tools each with a different approach
-      to supporting browser automation. These tools are highly flexible, allowing
-      many options for locating and manipulating elements within a browser, and one
-      of its key features is the support for automating multiple browser platforms.
-      This package contains .NET support utilites and classes that users may find
-      useful in using Selenium WebDriver. These support classes are mainly intended
-      to spark ideas of what is possible with Selenium WebDriver, and may not be
-      entirely appropriate for production use.
+      Selenium is a set of different software tools each with a different approach to supporting browser automation. These tools are highly flexible, allowing many options for locating and manipulating elements within a browser, and one of its key features is the support for automating multiple browser platforms. This package contains the .NET bindings for the concise and object-based Selenium WebDriver API, which uses native OS-level events to manipulate the browser, bypassing the JavaScript sandbox, and does not require the Selenium Server to automate the browser.
     </description>
     <projectUrl>https://selenium.dev</projectUrl>
-    <repository url="https://github.com/SeleniumHQ/selenium" />
+    <repository type="GitHub" url="https://github.com/SeleniumHQ/selenium" />
     <license type="expression">Apache-2.0</license>
     <iconUrl>https://selenium.dev/images/selenium_logo_square_green.png</iconUrl>
-    <icon>images\icon.png</icon>
+    <icon>icon.png</icon>
     <tags>selenium webdriver support browser automation</tags>
+    <releaseNotes>
+      See the latest changes, included in this release, at https://github.com/SeleniumHQ/selenium/blob/trunk/dotnet/CHANGELOG.
+    </releaseNotes>
     <dependencies>
       <group targetFramework="netstandard2.0">
         <dependency id="Selenium.WebDriver.StrongNamed" version="$version$" exclude="Build,Analyzers" />

dotnet/src/support/WebDriver.Support.nuspec

@@ -4,27 +4,23 @@
     <id>$packageid$</id>
     <version>$version$</version>
     <authors>Selenium Committers</authors>
-    <copyright>Copyright © 2020 Software Freedom Conservancy</copyright>
+    <copyright>Copyright © 2023 Software Freedom Conservancy</copyright>
     <owners>selenium</owners>
     <title>WebDriver Support</title>
     <requireLicenseAcceptance>false</requireLicenseAcceptance>
     <summary>Provides support classes for Selenium WebDriver</summary>
     <description>
-      Selenium is a set of different software tools each with a different approach
-      to supporting browser automation. These tools are highly flexible, allowing
-      many options for locating and manipulating elements within a browser, and one
-      of its key features is the support for automating multiple browser platforms.
-      This package contains .NET support utilites and classes that users may find
-      useful in using Selenium WebDriver. These support classes are mainly intended
-      to spark ideas of what is possible with Selenium WebDriver, and may not be
-      entirely appropriate for production use.
+      Selenium is a set of different software tools each with a different approach to supporting browser automation. These tools are highly flexible, allowing many options for locating and manipulating elements within a browser, and one of its key features is the support for automating multiple browser platforms. This package contains the .NET bindings for the concise and object-based Selenium WebDriver API, which uses native OS-level events to manipulate the browser, bypassing the JavaScript sandbox, and does not require the Selenium Server to automate the browser.
     </description>
     <projectUrl>https://selenium.dev</projectUrl>
-    <repository url="https://github.com/SeleniumHQ/selenium" />
+    <repository type="GitHub" url="https://github.com/SeleniumHQ/selenium" />
     <license type="expression">Apache-2.0</license>
     <iconUrl>https://selenium.dev/images/selenium_logo_square_green.png</iconUrl>
-    <icon>images\icon.png</icon>
+    <icon>icon.png</icon>
     <tags>selenium webdriver support browser automation</tags>
+    <releaseNotes>
+      See the latest changes, included in this release, at https://github.com/SeleniumHQ/selenium/blob/trunk/dotnet/CHANGELOG.
+    </releaseNotes>
     <dependencies>
       <group targetFramework="netstandard2.0">
         <dependency id="Selenium.WebDriver" version="$version$" exclude="Build,Analyzers" />

dotnet/src/webdriver/BUILD.bazel

@@ -82,25 +82,32 @@ csharp_library(
     ],
 )
 
+copy_file(
+    name = "readme",
+    src = "//dotnet/src/webdriver/assets:README.md",
+    out = "README.md",
+)
+
 copy_file(
     name = "props",
-    src = "//dotnet/src/webdriver/build:Selenium.WebDriver.targets",
+    src = "//dotnet/src/webdriver/assets:Selenium.WebDriver.targets",
     out = "Selenium.WebDriver.targets",
 )
 
 copy_file(
     name = "transitive-props",
-    src = "//dotnet/src/webdriver/build:Selenium.WebDriver.targets",
+    src = "//dotnet/src/webdriver/assets:Selenium.WebDriver.targets",
     out = "transitive.Selenium.WebDriver.targets",
 )
 
 nuget_pack(
     name = "webdriver",
     files = {
-        "//common/images:selenium_logo_small.png": "images/icon.png",
+        "//common/images:selenium_logo_small.png": "icon.png",
         "//common/manager:selenium-manager-linux": "manager/linux/selenium-manager",
         "//common/manager:selenium-manager-macos": "manager/macos/selenium-manager",
         "//common/manager:selenium-manager-windows": "manager/windows/selenium-manager.exe",
+        ":readme": "README.md",
         ":props": "build/Selenium.WebDriver.targets",
         ":transitive-props": "buildTransitive/Selenium.WebDriver.targets",
     },
@@ -121,10 +128,11 @@ nuget_pack(
 nuget_pack(
     name = "webdriver-strongnamed",
     files = {
-        "//common/images:selenium_logo_small.png": "images/icon.png",
+        "//common/images:selenium_logo_small.png": "icon.png",
         "//common/manager:selenium-manager-linux": "manager/linux/selenium-manager",
         "//common/manager:selenium-manager-macos": "manager/macos/selenium-manager",
         "//common/manager:selenium-manager-windows": "manager/windows/selenium-manager.exe",
+        ":readme": "README.md",
         ":props": "build/Selenium.WebDriver.StrongNamed.targets",
         ":transitive-props": "buildTransitive/Selenium.WebDriver.StrongNamed.targets",
     },

dotnet/src/webdriver/WebDriver.StrongNamed.nuspec

@@ -4,27 +4,24 @@
     <id>$packageid$</id>
     <version>$version$</version>
     <authors>Selenium Committers</authors>
-    <copyright>Copyright © 2020 Software Freedom Conservancy</copyright>
+    <copyright>Copyright © 2023 Software Freedom Conservancy</copyright>
     <owners>selenium</owners>
     <title>Selenium WebDriver</title>
     <requireLicenseAcceptance>false</requireLicenseAcceptance>
     <summary>.NET bindings for the Selenium WebDriver API</summary>
     <description>
-      Selenium is a set of different software tools each with a different approach
-      to supporting browser automation. These tools are highly flexible, allowing
-      many options for locating and manipulating elements within a browser, and one
-      of its key features is the support for automating multiple browser platforms.
-      This package contains the .NET bindings for the concise and object-based
-      Selenium WebDriver API, which uses native OS-level events to manipulate the
-      browser, bypassing the JavaScript sandbox, and does not require the Selenium
-      Server to automate the browser.
+      Selenium is a set of different software tools each with a different approach to supporting browser automation. These tools are highly flexible, allowing many options for locating and manipulating elements within a browser, and one of its key features is the support for automating multiple browser platforms. This package contains the .NET bindings for the concise and object-based Selenium WebDriver API, which uses native OS-level events to manipulate the browser, bypassing the JavaScript sandbox, and does not require the Selenium Server to automate the browser.
     </description>
     <projectUrl>https://selenium.dev</projectUrl>
-    <repository url="https://github.com/SeleniumHQ/selenium" />
+    <repository type="GitHub" url="https://github.com/SeleniumHQ/selenium" />
     <license type="expression">Apache-2.0</license>
     <iconUrl>https://selenium.dev/images/selenium_logo_square_green.png</iconUrl>
-    <icon>images\icon.png</icon>
+    <icon>icon.png</icon>
     <tags>selenium webdriver browser automation</tags>
+    <readme>README.md</readme>
+    <releaseNotes>
+      See the latest changes, included in this release, at https://github.com/SeleniumHQ/selenium/blob/trunk/dotnet/CHANGELOG.
+    </releaseNotes>
     <dependencies>
       <group targetFramework="netstandard2.0">
         <dependency id="Newtonsoft.Json" version="13.0.1" exclude="Build,Analyzers" />

dotnet/src/webdriver/WebDriver.csproj

@@ -93,19 +93,16 @@
 
   <PropertyGroup>
     <BaseSeleniumManagerPath>..\..\..\common\manager</BaseSeleniumManagerPath>
-  </PropertyGroup>
-
-  <PropertyGroup>
     <BaseImagePath>..\..\..\common\images</BaseImagePath>
   </PropertyGroup>
 
   <ItemGroup>
-    <None Include="build\Selenium.WebDriver.targets" Pack="true" PackagePath="build\" />
-    <None Include="build\Selenium.WebDriver.targets" Pack="true" PackagePath="buildTransitive\" />
+    <None Include="assets\Selenium.WebDriver.targets" Pack="true" PackagePath="build\" />
+    <None Include="assets\Selenium.WebDriver.targets" Pack="true" PackagePath="buildTransitive\" />
 
-    <None Include="$(BaseImagePath)\selenium_logo_small.png" Pack="true" PackagePath="\logo.png" Visible="false" />
+    <None Include="$(BaseImagePath)\selenium_logo_small.png" Pack="true" PackagePath="logo.png" Visible="false" />
 
-    <None Include="$(BaseSeleniumManagerPath)\linux\selenium-manager" Pack="true" PackagePath="\manager\linux" Visible="false" />
+    <None Include="$(BaseSeleniumManagerPath)\linux\selenium-manager" Pack="true" PackagePath="manager\linux" Visible="false" />
     <None Include="$(BaseSeleniumManagerPath)\macos\selenium-manager" Pack="true" PackagePath="manager\macos" Visible="false" />
     <None Include="$(BaseSeleniumManagerPath)\windows\selenium-manager.exe" Pack="true" PackagePath="manager\windows" Visible="false" />
   </ItemGroup>

dotnet/src/webdriver/WebDriver.nuspec

@@ -4,27 +4,24 @@
     <id>$packageid$</id>
     <version>$version$</version>
     <authors>Selenium Committers</authors>
-    <copyright>Copyright © 2020 Software Freedom Conservancy</copyright>
+    <copyright>Copyright © 2023 Software Freedom Conservancy</copyright>
     <owners>selenium</owners>
     <title>Selenium WebDriver</title>
     <requireLicenseAcceptance>false</requireLicenseAcceptance>
     <summary>.NET bindings for the Selenium WebDriver API</summary>
     <description>
-      Selenium is a set of different software tools each with a different approach
-      to supporting browser automation. These tools are highly flexible, allowing
-      many options for locating and manipulating elements within a browser, and one
-      of its key features is the support for automating multiple browser platforms.
-      This package contains the .NET bindings for the concise and object-based
-      Selenium WebDriver API, which uses native OS-level events to manipulate the
-      browser, bypassing the JavaScript sandbox, and does not require the Selenium
-      Server to automate the browser.
+      Selenium is a set of different software tools each with a different approach to supporting browser automation. These tools are highly flexible, allowing many options for locating and manipulating elements within a browser, and one of its key features is the support for automating multiple browser platforms. This package contains the .NET bindings for the concise and object-based Selenium WebDriver API, which uses native OS-level events to manipulate the browser, bypassing the JavaScript sandbox, and does not require the Selenium Server to automate the browser.
     </description>
     <projectUrl>https://selenium.dev</projectUrl>
-    <repository url="https://github.com/SeleniumHQ/selenium" />
+    <repository type="GitHub" url="https://github.com/SeleniumHQ/selenium" />
     <license type="expression">Apache-2.0</license>
     <iconUrl>https://selenium.dev/images/selenium_logo_square_green.png</iconUrl>
-    <icon>images\icon.png</icon>
+    <icon>icon.png</icon>
     <tags>selenium webdriver browser automation</tags>
+    <readme>README.md</readme>
+    <releaseNotes>
+      See the latest changes, included in this release, at https://github.com/SeleniumHQ/selenium/blob/trunk/dotnet/CHANGELOG.
+    </releaseNotes>
     <dependencies>
       <group targetFramework="netstandard2.0">
         <dependency id="Newtonsoft.Json" version="13.0.1" exclude="Build,Analyzers" />

dotnet/src/webdriver/build/BUILD.bazel → dotnet/src/webdriver/assets/BUILD.bazel

@@ -1,3 +1,4 @@
 exports_files([
+    "README.md",
     "Selenium.WebDriver.targets",
 ])

dotnet/src/webdriver/assets/README.md

@@ -0,0 +1,19 @@
+Selenium is a set of different software tools each with a different approach to supporting browser automation. These tools are highly flexible, allowing many options for locating and manipulating elements within a browser, and one of its key features is the support for automating multiple browser platforms. This package contains the .NET bindings for the concise and object-based Selenium WebDriver API, which uses native OS-level events to manipulate the browser, bypassing the JavaScript sandbox, and does not require the Selenium Server to automate the browser.
+
+# Usage
+
+```csharp
+using OpenQA.Selenium.Chrome;
+using OpenQA.Selenium;
+
+var driver = new ChromeDriver();
+
+driver.Url = "https://www.google.com";
+driver.FindElement(By.Name("q")).SendKeys("webdriver" + Keys.Return);
+Console.WriteLine(driver.Title);
+
+driver.Quit();
+```
+
+# Contributing
+Contributions are accepted either through [GitHub](https://github.com/SeleniumHQ/selenium/) pull requests or patches via the [Selenium issue tracker](https://github.com/SeleniumHQ/selenium/issues).

dotnet/test/common/WebDriver.Common.Tests.csproj

@@ -58,6 +58,6 @@
   <PropertyGroup>
     <Selenium_Manager_BinariesRootPath>..\..\..\common\manager</Selenium_Manager_BinariesRootPath>
   </PropertyGroup>
-  <Import Project="..\..\src\webdriver\build\Selenium.WebDriver.targets" />
+  <Import Project="..\..\src\webdriver\assets\Selenium.WebDriver.targets" />
 
 </Project>