Update refs, add MAUI docs

Author: JimBobSquarePants

.github/workflows/build.yml

@@ -51,7 +51,7 @@ jobs:
         run: git lfs pull
 
       - name: Install DocFX
-        run: choco install docfx -y
+        run: dotnet tool install -g docfx
 
       - name: Build
         shell: pwsh

articles/imagesharp/gettingstarted.md

@@ -121,3 +121,16 @@ If you are experiencing a significant performance gap between System.Drawing and
 A few troubleshooting steps to try:
 
 - Check the value of [Vector.IsHardwareAccelerated](https://docs.microsoft.com/en-us/dotnet/api/system.numerics.vector.ishardwareaccelerated?view=netcore-2.1&viewFallbackFrom=netstandard-2.0#System_Numerics_Vector_IsHardwareAccelerated). If the output is false, it means there is no SIMD support in your runtime!
+
+### MAUI
+ImageSharp performs well with MAUI on both iOS and Android in release mode when correctly configured. For Android we recommend enabling LLVM and AOT compilation in the project file:
+
+```xml
+<PropertyGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android' AND '$(Configuration)' == 'Release'">
+    <EnableLLVM>true</EnableLLVM>
+    <RunAOTCompilation>true</RunAOTCompilation>
+    <AndroidEnableProfiledAot>false</AndroidEnableProfiledAot>
+</PropertyGroup>
+```
+
+>[!NOTE] Android performance in Debug mode appears to be significantly slower than in Release mode, this is not due to issues within the library itself rather upstream issues in the .NET Runtime. The following [.NET Runtime issue](https://github.com/dotnet/runtime/issues/71210) contains more information.

build.ps1

@@ -1,18 +1,28 @@
-# Ensure all submodules are currently checked out to the latest tag.
+# Ensure all submodules are currently checked out to the latest commit/tag.
 git submodule update --init --recursive
 git submodule foreach git rm --cached -r .
 
 Get-ChildItem ./ext -Directory | ForEach-Object {
     $path = $_.FullName
+    
+    Write-Host "Processing submodule: $path"
 
+    # Fetch tags and check out the latest tag
     git -C "$path" fetch --tags
-    $lastTag = (git -C "$path" describe --tags $(git -C "$path" rev-list --tags --max-count=1))  | Out-String
-    $lastTag = $lastTag.Trim()
 
-    Write-Host "$path => $lastTag"
-    git -C "$path" reset --hard "$lastTag" --
+    # Get all tags, sort them alphabetically, and select the highest one
+    $highestTag = (git -C "$path" tag | Sort-Object -Descending)[0] | Out-String
+    $highestTag = $highestTag.Trim()
+    Write-Host "$path => $highestTag"
+
+    # Checkout the latest tag
+    git -C "$path" reset --hard "$highestTag"
+
+    # Forcefully clean the submodule directory, suppressing any prompts
+    git -C "$path" clean -fdx -q
 }
 
+
 # Ensure deterministic builds do not affect submodule build
 # TODO: Remove first two values once all projects are updated to latest build props.
 $env:CI = $false

docfx.json

@@ -12,7 +12,7 @@
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
       "properties": {
-        "TargetFramework": "netcoreapp3.1"
+        
       }
     },
     {
@@ -27,7 +27,7 @@
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
       "properties": {
-        "TargetFramework": "netcoreapp3.1"
+        
       }
     },
     {
@@ -42,7 +42,7 @@
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
       "properties": {
-        "TargetFramework": "netcoreapp3.1"
+        
       }
     },
     {
@@ -57,7 +57,7 @@
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
       "properties": {
-        "TargetFramework": "netcoreapp3.1"
+        
       }
     },
     {
@@ -72,7 +72,7 @@
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
       "properties": {
-        "TargetFramework": "netcoreapp3.1"
+        
       }
     },
     {
@@ -87,7 +87,7 @@
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
       "properties": {
-        "TargetFramework": "netcoreapp3.1"
+        
       }
     }
   ],