Update sample projects & samples in docs (#2823)

* update them all

* more docs

* moar docs

samples/ShardedClient/Program.cs

@@ -8,78 +8,70 @@ using System;
 using System.Threading;
 using System.Threading.Tasks;
 
-namespace ShardedClient
+namespace ShardedClient;
+
+// This is a minimal example of using Discord.Net's Sharded Client
+// The provided DiscordShardedClient class simplifies having multiple
+// DiscordSocketClient instances (or shards) to serve a large number of guilds.
+class Program
 {
-    // This is a minimal example of using Discord.Net's Sharded Client
-    // The provided DiscordShardedClient class simplifies having multiple
-    // DiscordSocketClient instances (or shards) to serve a large number of guilds.
-    class Program
+    public static async Task Main(string[] args)
     {
-        static void Main(string[] args)
-            => new Program()
-                .MainAsync()
-                .GetAwaiter()
-                .GetResult();
-
-        public async Task MainAsync()
+        // You specify the amount of shards you'd like to have with the
+        // DiscordSocketConfig. Generally, it's recommended to
+        // have 1 shard per 1500-2000 guilds your bot is in.
+        var config = new DiscordSocketConfig
         {
-            // You specify the amount of shards you'd like to have with the
-            // DiscordSocketConfig. Generally, it's recommended to
-            // have 1 shard per 1500-2000 guilds your bot is in.
-            var config = new DiscordSocketConfig
-            {
-                TotalShards = 2,
-                GatewayIntents = GatewayIntents.AllUnprivileged | GatewayIntents.MessageContent
-            };
+            TotalShards = 2,
+            GatewayIntents = GatewayIntents.AllUnprivileged | GatewayIntents.MessageContent
+        };
 
-            // You should dispose a service provider created using ASP.NET
-            // when you are finished using it, at the end of your app's lifetime.
-            // If you use another dependency injection framework, you should inspect
-            // its documentation for the best way to do this.
-            using (var services = ConfigureServices(config))
-            {
-                var client = services.GetRequiredService<DiscordShardedClient>();
+        // You should dispose a service provider created using ASP.NET
+        // when you are finished using it, at the end of your app's lifetime.
+        // If you use another dependency injection framework, you should inspect
+        // its documentation for the best way to do this.
+        await using var services = ConfigureServices(config);
 
-                // The Sharded Client does not have a Ready event.
-                // The ShardReady event is used instead, allowing for individual
-                // control per shard.
-                client.ShardReady += ReadyAsync;
-                client.Log += LogAsync;
+        var client = services.GetRequiredService<DiscordShardedClient>();
 
-                await services.GetRequiredService<InteractionHandlingService>()
-                    .InitializeAsync();
+        // The Sharded Client does not have a Ready event.
+        // The ShardReady event is used instead, allowing for individual
+        // control per shard.
+        client.ShardReady += ReadyAsync;
+        client.Log += LogAsync;
 
-                await services.GetRequiredService<CommandHandlingService>()
-                    .InitializeAsync();
+        await services.GetRequiredService<InteractionHandlingService>()
+            .InitializeAsync();
 
-                // Tokens should be considered secret data, and never hard-coded.
-                await client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
-                await client.StartAsync();
+        await services.GetRequiredService<CommandHandlingService>()
+            .InitializeAsync();
 
-                await Task.Delay(Timeout.Infinite);
-            }
-        }
+        // Tokens should be considered secret data, and never hard-coded.
+        await client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("token"));
+        await client.StartAsync();
 
-        private ServiceProvider ConfigureServices(DiscordSocketConfig config)
-            => new ServiceCollection()
-                .AddSingleton(new DiscordShardedClient(config))
-                .AddSingleton<CommandService>()
-                .AddSingleton(x => new InteractionService(x.GetRequiredService<DiscordShardedClient>()))
-                .AddSingleton<CommandHandlingService>()
-                .AddSingleton<InteractionHandlingService>()
-                .BuildServiceProvider();
+        await Task.Delay(Timeout.Infinite);
+    }
+
+    private static ServiceProvider ConfigureServices(DiscordSocketConfig config)
+        => new ServiceCollection()
+            .AddSingleton(new DiscordShardedClient(config))
+            .AddSingleton<CommandService>()
+            .AddSingleton(x => new InteractionService(x.GetRequiredService<DiscordShardedClient>()))
+            .AddSingleton<CommandHandlingService>()
+            .AddSingleton<InteractionHandlingService>()
+            .BuildServiceProvider();
 
 
-        private Task ReadyAsync(DiscordSocketClient shard)
-        {
-            Console.WriteLine($"Shard Number {shard.ShardId} is connected and ready!");
-            return Task.CompletedTask;
-        }
+    private static Task ReadyAsync(DiscordSocketClient shard)
+    {
+        Console.WriteLine($"Shard Number {shard.ShardId} is connected and ready!");
+        return Task.CompletedTask;
+    }
 
-        private Task LogAsync(LogMessage log)
-        {
-            Console.WriteLine(log.ToString());
-            return Task.CompletedTask;
-        }
+    private static Task LogAsync(LogMessage log)
+    {
+        Console.WriteLine(log.ToString());
+        return Task.CompletedTask;
     }
 }