From 7d71064d1597369582a6c846affab0e0f0726ede Mon Sep 17 00:00:00 2001
From: Marc Gravell <marc.gravell@gmail.com>
Date: Thu, 7 Nov 2024 15:51:55 +0000
Subject: [PATCH 1/2] package garnet-server as a .NET tool

---
 main/GarnetServer/GarnetServer.csproj | 27 +++++++++++++++++++++++++++
 main/GarnetServer/readme.md           |  9 +++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 main/GarnetServer/readme.md

diff --git a/main/GarnetServer/GarnetServer.csproj b/main/GarnetServer/GarnetServer.csproj
index 672c07f6c9..584641a216 100644
--- a/main/GarnetServer/GarnetServer.csproj
+++ b/main/GarnetServer/GarnetServer.csproj
@@ -3,6 +3,29 @@
   <PropertyGroup>
     <OutputType>Exe</OutputType>
     <ServerGarbageCollection>true</ServerGarbageCollection>
+
+    <!-- IMPORTANT: Keep the version in sync with .azure\pipelines\azure-pipelines-external-release.yml line ~6. -->
+    <Version>1.0.36</Version>
+    <PackageId>garnet-server</PackageId>
+    <PackAsTool>true</PackAsTool>
+    <ToolCommandName>garnet-server</ToolCommandName>
+    <Title>The Microsoft.Garnet RESP server, packaged as a .NET tool</Title>
+    <GeneratePackageOnBuild Condition="'$(Configuration)'=='Release'">True</GeneratePackageOnBuild>
+    <Authors>Microsoft</Authors>
+    <Company>Microsoft</Company>
+    <RepositoryType>git</RepositoryType>
+    <RepositoryUrl>https://github.com/microsoft/garnet.git</RepositoryUrl>
+    <PackageProjectUrl>https://microsoft.github.io/garnet</PackageProjectUrl>
+    <PackageLicenseExpression>MIT</PackageLicenseExpression>
+    <PackageRequireLicenseAcceptance>True</PackageRequireLicenseAcceptance>
+    <Description>
+      Garnet is a remote cache-store from Microsoft Research, that offers strong performance (throughput and latency),
+      scalability, storage, recovery, cluster sharding, key migration, and replication features. Garnet uses the Redis RESP wire
+      protocol and can work with existing Redis clients.
+    </Description>
+    <PackageReleaseNotes>See https://github.com/microsoft/garnet for details.</PackageReleaseNotes>
+    <Copyright>© Microsoft Corporation. All rights reserved.</Copyright>
+    <Tags>Garnet key-value store cache dictionary hashtable concurrent persistent remote cluster Redis RESP</Tags>
   </PropertyGroup>
 
   <ItemGroup>
@@ -21,6 +44,10 @@
     <None Update="garnet.conf">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
+    <None Include="readme.md" Pack="true" PackagePath="/" />
   </ItemGroup>
 
+  <PropertyGroup>
+    <PackageReadmeFile>readme.md</PackageReadmeFile>
+  </PropertyGroup>
 </Project>
\ No newline at end of file
diff --git a/main/GarnetServer/readme.md b/main/GarnetServer/readme.md
new file mode 100644
index 0000000000..3b238215e2
--- /dev/null
+++ b/main/GarnetServer/readme.md
@@ -0,0 +1,9 @@
+# garnet-server
+
+`garnet-server` is a .NET global tool that provides the [`Microsoft.Garnet`](https://www.nuget.org/packages/Microsoft.Garnet) RESP server.
+
+The `garnet-server` by itself will create a Garnet server using the default port; for full options, see `garnet-server --help`.
+
+
+- [Full Garnet documentation](https://microsoft.github.io/garnet/)
+- [Garnet GitHub repository](https://github.com/microsoft/garnet.git)
\ No newline at end of file

From b433fdbce5882a15e41b09ca0cffb0d9f68525bd Mon Sep 17 00:00:00 2001
From: Marc Gravell <marc.gravell@gmail.com>
Date: Thu, 7 Nov 2024 16:00:25 +0000
Subject: [PATCH 2/2] docs

---
 website/docs/welcome/releases.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/website/docs/welcome/releases.md b/website/docs/welcome/releases.md
index fa4adecdac..ccc70f420c 100644
--- a/website/docs/welcome/releases.md
+++ b/website/docs/welcome/releases.md
@@ -8,6 +8,16 @@ title: Releases
 
 Find releases at [https://github.com/microsoft/garnet/releases](https://github.com/microsoft/garnet/releases).
 
+## .NET Tool
+
+Garnet can be installed as a [.NET tool](https://aka.ms/global-tools):
+
+``` txt
+> dotnet tool install --global garnet-server
+>
+> garnet-server
+```
+
 ## NuGet
 
 Find releases at [https://www.nuget.org/packages/Microsoft.Garnet](https://www.nuget.org/packages/Microsoft.Garnet). The NuGet