Update READMEs to include complete samples with grain references, calls, and shutdown

Co-authored-by: ReubenBond <[email protected]>

Author: Copilot

src/AWS/Orleans.Clustering.DynamoDB/README.md

@@ -14,6 +14,9 @@ dotnet add package Microsoft.Orleans.Clustering.DynamoDB
 ```csharp
 using Microsoft.Extensions.Hosting;
 using Orleans.Hosting;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Threading.Tasks;
 
 var builder = new HostBuilder()
     .UseOrleans(siloBuilder =>
@@ -30,13 +33,24 @@ var builder = new HostBuilder()
             });
     });
 
-// Run the host
-await builder.RunConsoleAsync();
+var host = builder.Build();
+await host.StartAsync();
+
+// Get a reference to a grain and call it
+var client = host.Services.GetRequiredService<IClusterClient>();
+var grain = client.GetGrain<IHelloGrain>("user123");
+var response = await grain.SayHello("DynamoDB");
+
+// Print the result
+Console.WriteLine($"Grain response: {response}");
+
+// Keep the host running until the application is shut down
+await host.WaitForShutdownAsync();
 ```
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Configuration Guide](https://learn.microsoft.com/en-us/dotnet/orleans/host/configuration-guide/)
 - [Orleans Clustering](https://learn.microsoft.com/en-us/dotnet/orleans/implementation/cluster-management)
 - [AWS SDK for .NET Documentation](https://docs.aws.amazon.com/sdk-for-net/index.html)

src/AWS/Orleans.Persistence.DynamoDB/README.md

@@ -74,7 +74,7 @@ public class MyGrain : Grain, IMyGrain, IGrainWithStringKey
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Grain Persistence](https://learn.microsoft.com/en-us/dotnet/orleans/grains/grain-persistence)
 - [AWS SDK for .NET Documentation](https://docs.aws.amazon.com/sdk-for-net/index.html)
 

src/AWS/Orleans.Reminders.DynamoDB/README.md

@@ -75,7 +75,7 @@ public class ReminderGrain : Grain, IReminderGrain, IRemindable
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Reminders and Timers](https://learn.microsoft.com/en-us/dotnet/orleans/grains/timers-and-reminders)
 - [Reminder Services](https://learn.microsoft.com/en-us/dotnet/orleans/implementation/reminder-services)
 - [AWS SDK for .NET Documentation](https://docs.aws.amazon.com/sdk-for-net/index.html)

src/AWS/Orleans.Streaming.SQS/README.md

@@ -98,7 +98,7 @@ public class ConsumerGrain : Grain, IConsumerGrain, IAsyncObserver<string>
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Orleans Streams](https://learn.microsoft.com/en-us/dotnet/orleans/streaming/index)
 - [Stream Providers](https://learn.microsoft.com/en-us/dotnet/orleans/streaming/stream-providers)
 - [AWS SDK for .NET Documentation](https://docs.aws.amazon.com/sdk-for-net/index.html)

src/AdoNet/Orleans.Clustering.AdoNet/README.md

@@ -24,6 +24,9 @@ You will also need to install the appropriate database driver package for your d
 using Microsoft.Extensions.Hosting;
 using Orleans.Configuration;
 using Orleans.Hosting;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Threading.Tasks;
 
 var builder = Host.CreateApplicationBuilder(args)
     .UseOrleans(siloBuilder =>
@@ -37,8 +40,19 @@ var builder = Host.CreateApplicationBuilder(args)
             });
     });
 
-// Run the host
-await builder.RunConsoleAsync();
+var host = builder.Build();
+await host.StartAsync();
+
+// Get a reference to a grain and call it
+var client = host.Services.GetRequiredService<IClusterClient>();
+var grain = client.GetGrain<IHelloGrain>("user123");
+var response = await grain.SayHello("World");
+
+// Print the result
+Console.WriteLine($"Grain response: {response}");
+
+// Keep the host running until the application is shut down
+await host.WaitForShutdownAsync();
 ```
 
 ## Example - Configuring Client to Connect to Cluster
@@ -47,6 +61,9 @@ await builder.RunConsoleAsync();
 using Microsoft.Extensions.Hosting;
 using Orleans;
 using Orleans.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Threading.Tasks;
 
 var clientBuilder = Host.CreateApplicationBuilder(args)
     .UseOrleansClient(clientBuilder =>
@@ -60,13 +77,17 @@ var clientBuilder = Host.CreateApplicationBuilder(args)
             });
     });
 
-var host = await clientBuilder.StartAsync();
+var host = clientBuilder.Build();
+await host.StartAsync();
 var client = host.Services.GetRequiredService<IClusterClient>();
 
 // Get a reference to a grain and call it
 var grain = client.GetGrain<IHelloGrain>("user123");
 var response = await grain.SayHello("World");
 
+// Print the result
+Console.WriteLine($"Grain response: {response}");
+
 // Keep the host running until the application is shut down
 await host.WaitForShutdownAsync();
 ```

src/AdoNet/Orleans.Persistence.AdoNet/README.md

@@ -92,7 +92,7 @@ Before using the ADO.NET provider, you need to set up the necessary database tab
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Grain Persistence](https://learn.microsoft.com/en-us/dotnet/orleans/grains/grain-persistence)
 - [Relational Database Persistence](https://learn.microsoft.com/en-us/dotnet/orleans/grains/grain-persistence/relational-storage)
 

src/AdoNet/Orleans.Reminders.AdoNet/README.md

@@ -85,7 +85,7 @@ public class ReminderGrain : Grain, IReminderGrain, IRemindable
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Reminders and Timers](https://learn.microsoft.com/en-us/dotnet/orleans/grains/timers-and-reminders)
 - [Reminder Services](https://learn.microsoft.com/en-us/dotnet/orleans/implementation/reminder-services)
 - [ADO.NET Database Setup](https://learn.microsoft.com/en-us/dotnet/orleans/host/configuration-guide/adonet-configuration)

src/AdoNet/Orleans.Streaming.AdoNet/README.md

@@ -110,7 +110,7 @@ public class ConsumerGrain : Grain, IConsumerGrain, IAsyncObserver<string>
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Orleans Streams](https://learn.microsoft.com/en-us/dotnet/orleans/streaming/index)
 - [Stream Providers](https://learn.microsoft.com/en-us/dotnet/orleans/streaming/stream-providers)
 - [ADO.NET Database Setup](https://learn.microsoft.com/en-us/dotnet/orleans/host/configuration-guide/adonet-configuration)

src/Azure/Orleans.Clustering.AzureStorage/README.md

@@ -16,6 +16,9 @@ dotnet add package Microsoft.Orleans.Clustering.AzureStorage
 using Microsoft.Extensions.Hosting;
 using Orleans.Configuration;
 using Orleans.Hosting;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Threading.Tasks;
 
 var builder = new HostBuilder()
     .UseOrleans(siloBuilder =>
@@ -34,8 +37,19 @@ var builder = new HostBuilder()
             });
     });
 
-// Run the host
-await builder.RunConsoleAsync();
+var host = builder.Build();
+await host.StartAsync();
+
+// Get a reference to a grain and call it
+var client = host.Services.GetRequiredService<IClusterClient>();
+var grain = client.GetGrain<IHelloGrain>("user123");
+var response = await grain.SayHello("World");
+
+// Print the result
+Console.WriteLine($"Grain response: {response}");
+
+// Keep the host running until the application is shut down
+await host.WaitForShutdownAsync();
 ```
 
 ## Example - Configuring Client to Connect to Cluster
@@ -44,6 +58,9 @@ await builder.RunConsoleAsync();
 using Microsoft.Extensions.Hosting;
 using Orleans;
 using Orleans.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using System;
+using System.Threading.Tasks;
 
 var clientBuilder = new HostBuilder()
     .UseOrleansClient(clientBuilder =>
@@ -62,13 +79,24 @@ var clientBuilder = new HostBuilder()
             });
     });
 
-var host = await clientBuilder.StartAsync();
+var host = clientBuilder.Build();
+await host.StartAsync();
 var client = host.Services.GetRequiredService<IClusterClient>();
+
+// Get a reference to a grain and call it
+var grain = client.GetGrain<IHelloGrain>("user123");
+var response = await grain.SayHello("World");
+
+// Print the result
+Console.WriteLine($"Grain response: {response}");
+
+// Keep the host running until the application is shut down
+await host.WaitForShutdownAsync();
 ```
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Clustering providers](https://learn.microsoft.com/en-us/dotnet/orleans/implementation/cluster-management)
 - [Azure Storage provider](https://learn.microsoft.com/en-us/dotnet/orleans/implementation/azure-storage-providers)
 

src/Azure/Orleans.Clustering.Cosmos/README.md

@@ -34,7 +34,7 @@ await builder.RunConsoleAsync();
 
 ## Documentation
 For more comprehensive documentation, please refer to:
-- [Microsoft Orleans Documentation](https://docs.microsoft.com/dotnet/orleans/)
+- [Microsoft Orleans Documentation](https://learn.microsoft.com/dotnet/orleans/)
 - [Configuration Guide](https://learn.microsoft.com/en-us/dotnet/orleans/host/configuration-guide/)
 - [Orleans Clustering](https://learn.microsoft.com/en-us/dotnet/orleans/implementation/cluster-management)