Modernize provider projects and test infrastructure

Adopt shared SDK build settings, update provider and test package references, and bring the library code into compliance with the stricter analyzer and XML documentation requirements.

The earlier build churn was driven by stale intermediates plus missing documentation and async/test-platform cleanup in the SDK-style projects, so this commit makes the provider libraries and test suite build and run cleanly under the current toolchain.

Author: niemyjski

Directory.Build.props

@@ -11,5 +11,18 @@
     <RepositoryType>git</RepositoryType>
     <ImplicitUsings>enable</ImplicitUsings>
     <LangVersion>latest</LangVersion>
+    <MinVerTagPrefix>v</MinVerTagPrefix>
+    <MinVerMinimumMajorMinor>5.0</MinVerMinimumMajorMinor>
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <EmbedUntrackedSources>true</EmbedUntrackedSources>
+    <AccelerateBuildsInVisualStudio>true</AccelerateBuildsInVisualStudio>
+    <SatelliteResourceLanguages>en</SatelliteResourceLanguages>
   </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="10.0.201" PrivateAssets="All"/>
+    <PackageReference Include="AsyncFixer" Version="2.1.0" PrivateAssets="All" />
+    <PackageReference Include="MinVer" Version="7.0.0" PrivateAssets="All" />
+  </ItemGroup>
 </Project>

src/Geocoding.Core/Address.cs

@@ -12,13 +12,22 @@ public abstract class Address
 		Location coordinates;
 		string provider = string.Empty;
 
+		/// <summary>
+		/// Initializes a new address instance.
+		/// </summary>
+		/// <param name="formattedAddress">The provider formatted address string.</param>
+		/// <param name="coordinates">The geocoded coordinates.</param>
+		/// <param name="provider">The provider name that produced this address.</param>
 		public Address(string formattedAddress, Location coordinates, string provider)
 		{
 			FormattedAddress = formattedAddress;
 			Coordinates = coordinates;
 			Provider = provider;
 		}
 
+		/// <summary>
+		/// Gets or sets the full formatted address.
+		/// </summary>
 		public virtual string FormattedAddress
 		{
 			get { return formattedAddress; }
@@ -31,6 +40,9 @@ public virtual string FormattedAddress
 			}
 		}
 
+		/// <summary>
+		/// Gets or sets the latitude and longitude for this address.
+		/// </summary>
 		public virtual Location Coordinates
 		{
 			get { return coordinates; }
@@ -43,6 +55,9 @@ public virtual Location Coordinates
 			}
 		}
 
+		/// <summary>
+		/// Gets the provider name for this address.
+		/// </summary>
 		public virtual string Provider
 		{
 			get { return provider; }
@@ -55,16 +70,31 @@ protected set
 			}
 		}
 
+		/// <summary>
+		/// Calculates the distance from this address to another address in miles.
+		/// </summary>
+		/// <param name="address">The destination address.</param>
+		/// <returns>The distance between the two addresses.</returns>
 		public virtual Distance DistanceBetween(Address address)
 		{
 			return this.Coordinates.DistanceBetween(address.Coordinates);
 		}
 
+		/// <summary>
+		/// Calculates the distance from this address to another address.
+		/// </summary>
+		/// <param name="address">The destination address.</param>
+		/// <param name="units">The unit to return the distance in.</param>
+		/// <returns>The distance between the two addresses.</returns>
 		public virtual Distance DistanceBetween(Address address, DistanceUnits units)
 		{
 			return this.Coordinates.DistanceBetween(address.Coordinates, units);
 		}
 
+		/// <summary>
+		/// Returns the formatted address.
+		/// </summary>
+		/// <returns>The formatted address.</returns>
 		public override string ToString()
 		{
 			return FormattedAddress;

src/Geocoding.Core/Bounds.cs

@@ -3,24 +3,45 @@
 
 namespace Geocoding
 {
+	/// <summary>
+	/// Represents a rectangular viewport defined by southwest and northeast coordinates.
+	/// </summary>
 	public class Bounds
 	{
 		readonly Location southWest;
 		readonly Location northEast;
 
+		/// <summary>
+		/// Gets the southwest corner.
+		/// </summary>
 		public Location SouthWest
 		{
 			get { return southWest; }
 		}
 
+		/// <summary>
+		/// Gets the northeast corner.
+		/// </summary>
 		public Location NorthEast
 		{
 			get { return northEast; }
 		}
 
+		/// <summary>
+		/// Initializes bounds from raw latitude and longitude values.
+		/// </summary>
+		/// <param name="southWestLatitude">The southwest latitude.</param>
+		/// <param name="southWestLongitude">The southwest longitude.</param>
+		/// <param name="northEastLatitude">The northeast latitude.</param>
+		/// <param name="northEastLongitude">The northeast longitude.</param>
 		public Bounds(double southWestLatitude, double southWestLongitude, double northEastLatitude, double northEastLongitude)
 			: this(new Location(southWestLatitude, southWestLongitude), new Location(northEastLatitude, northEastLongitude)) { }
 
+		/// <summary>
+		/// Initializes bounds from two corner locations.
+		/// </summary>
+		/// <param name="southWest">The southwest corner.</param>
+		/// <param name="northEast">The northeast corner.</param>
 		[JsonConstructor]
 		public Bounds(Location southWest, Location northEast)
 		{
@@ -37,11 +58,21 @@ public Bounds(Location southWest, Location northEast)
 			this.northEast = northEast;
 		}
 
+		/// <summary>
+		/// Determines whether the specified object is equal to the current bounds.
+		/// </summary>
+		/// <param name="obj">The object to compare.</param>
+		/// <returns><c>true</c> when equal; otherwise <c>false</c>.</returns>
 		public override bool Equals(object obj)
 		{
 			return Equals(obj as Bounds);
 		}
 
+		/// <summary>
+		/// Determines whether another bounds instance is equal to the current one.
+		/// </summary>
+		/// <param name="bounds">The other bounds instance.</param>
+		/// <returns><c>true</c> when equal; otherwise <c>false</c>.</returns>
 		public bool Equals(Bounds bounds)
 		{
 			if (bounds == null)
@@ -50,11 +81,19 @@ public bool Equals(Bounds bounds)
 			return (this.SouthWest.Equals(bounds.SouthWest) && this.NorthEast.Equals(bounds.NorthEast));
 		}
 
+		/// <summary>
+		/// Returns a hash code for the current bounds.
+		/// </summary>
+		/// <returns>A hash code for the current bounds.</returns>
 		public override int GetHashCode()
 		{
 			return SouthWest.GetHashCode() ^ NorthEast.GetHashCode();
 		}
 
+		/// <summary>
+		/// Returns a string representation of the bounds.
+		/// </summary>
+		/// <returns>A string representation of the bounds.</returns>
 		public override string ToString()
 		{
 			return string.Format("{0} | {1}", southWest, northEast);