Merge branch 'main' into hotfix/titlelize_fix

.gitattributes

@@ -60,3 +60,6 @@
 *.PDF  diff=astextplain
 *.rtf  diff=astextplain
 *.RTF  diff=astextplain
+
+
+*.verified.txt text eol=lf working-tree-encoding=UTF-8

azure-pipelines.yml

@@ -6,7 +6,7 @@ pr:
 - main
 - rel/*
 
-variables: 
+variables:
   BuildConfiguration: Release
   DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
 
@@ -19,24 +19,11 @@ stages:
 
     steps:
     - task: UseDotNet@2
-      displayName: 'Use .NET Core SDK 6.x'
+      displayName: 'Use .NET Core SDK 8.x'
       inputs:
-        version: 6.x
-        includePreviewVersions: true
+        version: 8.x
 
-    - task: UseDotNet@2
-      displayName: 'Use .NET Core Runtime 5.x'
-      inputs:
-        version: 5.x
-        packageType: runtime 
-
-    - task: UseDotNet@2
-      displayName: 'Use .NET Core Runtime 3.x'
-      inputs:
-        version: 3.x
-        packageType: runtime 
-
-    - task: DotNetCoreCLI@2  
+    - task: DotNetCoreCLI@2
       inputs:
         command: custom
         custom: tool
@@ -72,7 +59,7 @@ stages:
                     -Properties "version=$($version.NuGetPackageVersion);RepositoryType=git;RepositoryCommit=$($version.GitCommitId);RepositoryUrl=https://github.com/Humanizr/Humanizer" 
         }
       displayName: Create packages
-      
+
     - task: DotNetCoreCLI@2
       inputs:
         command: test
@@ -110,7 +97,7 @@ stages:
   - deployment: CodeSign
     displayName: Code Signing
     pool:
-      vmImage: windows-latest    
+      vmImage: windows-latest
     environment: Code Sign
     variables:
     - group: SignClient Credentials
@@ -136,7 +123,7 @@ stages:
               --description "Humanizer" `
               --descriptionUrl "https://github.com/Humanizr/Humanizer"
             displayName: Sign packages
-              
+
           - publish: $(Pipeline.Workspace)/BuildPackages
             displayName: Publish Signed Packages
             artifact: SignedPackages

readme.md

@@ -1114,18 +1114,18 @@ Humanizer includes methods to change a numeric heading to words. The heading can
 
 ```C#
 360.ToHeading();
-// north
+// N
 720.ToHeading();
-// north
+// N
 ```
 
-In order to retrieve a short version of the heading you can use the following call:
+In order to retrieve a full version of the heading, use the following call:
 
 ```C#
-180.ToHeading(true);
-// S
-360.ToHeading(true);
-// N
+180.ToHeading(HeadingStyle.Full);
+// south
+360.ToHeading(HeadingStyle.Full);
+// north
 ```
 
 Please note that a textual representation has a maximum deviation of 11.25°.

src/Directory.build.props

@@ -3,10 +3,11 @@
     <LangVersion>latest</LangVersion>
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
     <EmbedUntrackedSources>true</EmbedUntrackedSources>
+    <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Nerdbank.GitVersioning" Version="3.4.255" PrivateAssets="all" />
+    <PackageReference Include="Nerdbank.GitVersioning" Version="3.6.133" PrivateAssets="all" />
     <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" PrivateAssets="All"/>
   </ItemGroup>
 

src/Humanizer.Tests.Shared/ArticlePrefixSortTests.cs

@@ -1,7 +1,4 @@
-using System;
-using Xunit;
-
-namespace Humanizer.Tests
+namespace Humanizer.Tests
 {
     public class ArticlePrefixSortTests
     {

src/Humanizer.Tests.Shared/BitFieldEnumHumanizeTests.cs

@@ -1,6 +1,4 @@
-using Xunit;
-
-namespace Humanizer.Tests
+namespace Humanizer.Tests
 {
     [UseCulture("en")]
     public class BitFieldEnumHumanizeTests

src/Humanizer.Tests.Shared/BitFieldEnumUnderTest.cs

@@ -1,5 +1,4 @@
-using System;
-using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations;
 
 namespace Humanizer.Tests
 {

src/Humanizer.Tests.Shared/Bytes/ArithmeticTests.cs

@@ -1,5 +1,4 @@
 using Humanizer.Bytes;
-using Xunit;
 
 namespace Humanizer.Tests.Bytes
 {

src/Humanizer.Tests.Shared/Bytes/ByteRateTests.cs

@@ -1,7 +1,5 @@
-using System;
-using Humanizer.Bytes;
+using Humanizer.Bytes;
 using Humanizer.Localisation;
-using Xunit;
 
 namespace Humanizer.Tests.Bytes
 {
@@ -67,7 +65,7 @@ public void FormattedTimeUnitTests(long bytes, int measurementIntervalSeconds, T
         [InlineData(TimeUnit.Month)]
         [InlineData(TimeUnit.Week)]
         [InlineData(TimeUnit.Year)]
-        public void ThowsOnUnsupportedData(TimeUnit units)
+        public void ThrowsOnUnsupportedData(TimeUnit units)
         {
             var dummyRate = ByteSize.FromBits(1).Per(TimeSpan.FromSeconds(1));
 

src/Humanizer.Tests.Shared/Bytes/ByteSizeExtensionsTests.cs

@@ -1,6 +1,5 @@
 using System.Globalization;
 using Humanizer.Bytes;
-using Xunit;
 
 namespace Humanizer.Tests.Bytes
 {

src/Humanizer.Tests.Shared/Bytes/ComparingTests.cs

@@ -1,7 +1,4 @@
-using System.Collections.Generic;
-using System.Linq;
-using Humanizer.Bytes;
-using Xunit;
+using Humanizer.Bytes;
 
 namespace Humanizer.Tests.Bytes
 {

src/Humanizer.Tests.Shared/Bytes/CreatingTests.cs

@@ -21,7 +21,6 @@
 //THE SOFTWARE.
 
 using Humanizer.Bytes;
-using Xunit;
 
 namespace Humanizer.Tests.Bytes
 {

src/Humanizer.Tests.Shared/Bytes/ParsingTests.cs

@@ -20,10 +20,8 @@
 //OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 //THE SOFTWARE.
 
-using System;
 using System.Globalization;
 using Humanizer.Bytes;
-using Xunit;
 
 namespace Humanizer.Tests.Bytes
 {

src/Humanizer.Tests.Shared/Bytes/ToFullWordsTests.cs

@@ -21,7 +21,6 @@
 //THE SOFTWARE.
 
 using Humanizer.Bytes;
-using Xunit;
 
 namespace Humanizer.Tests.Bytes
 {