docs: Improved DI documentation (#2407)

docs/guides/text_commands/samples/dependency-injection/dependency_map_setup.cs

@@ -1,65 +0,0 @@
-public class Initialize
-{
-	private readonly CommandService _commands;
-	private readonly DiscordSocketClient _client;
-
-	// Ask if there are existing CommandService and DiscordSocketClient
-	// instance. If there are, we retrieve them and add them to the
-	// DI container; if not, we create our own.
-	public Initialize(CommandService commands = null, DiscordSocketClient client = null)
-	{
-		_commands = commands ?? new CommandService();
-		_client = client ?? new DiscordSocketClient();
-	}
-
-	public IServiceProvider BuildServiceProvider() => new ServiceCollection()
-		.AddSingleton(_client)
-		.AddSingleton(_commands)
-		// You can pass in an instance of the desired type
-		.AddSingleton(new NotificationService())
-		// ...or by using the generic method.
-		//
-		// The benefit of using the generic method is that 
-		// ASP.NET DI will attempt to inject the required
-		// dependencies that are specified under the constructor 
-		// for us.
-		.AddSingleton<DatabaseService>()
-		.AddSingleton<CommandHandler>()
-		.BuildServiceProvider();
-}
-public class CommandHandler
-{
-	private readonly DiscordSocketClient _client;
-	private readonly CommandService _commands;
-	private readonly IServiceProvider _services;
-
-	public CommandHandler(IServiceProvider services, CommandService commands, DiscordSocketClient client)
-	{
-		_commands = commands;
-		_services = services;
-		_client = client;
-	}
-
-	public async Task InitializeAsync()
-	{
-		// Pass the service provider to the second parameter of
-		// AddModulesAsync to inject dependencies to all modules 
-		// that may require them.
-		await _commands.AddModulesAsync(
-			assembly: Assembly.GetEntryAssembly(), 
-			services: _services);
-		_client.MessageReceived += HandleCommandAsync;
-	}
-
-	public async Task HandleCommandAsync(SocketMessage msg)
-	{
-		// ...
-		// Pass the service provider to the ExecuteAsync method for
-		// precondition checks.
-		await _commands.ExecuteAsync(
-			context: context, 
-			argPos: argPos, 
-			services: _services);
-		// ...
-	}
-}

docs/guides/text_commands/samples/dependency-injection/dependency_module.cs

@@ -1,37 +0,0 @@
-// After setting up dependency injection, modules will need to request
-// the dependencies to let the library know to pass 
-// them along during execution.
-
-// Dependency can be injected in two ways with Discord.Net.
-// You may inject any required dependencies via...
-// the module constructor
-// -or-
-// public settable properties
-
-// Injection via constructor
-public class DatabaseModule : ModuleBase<SocketCommandContext>
-{
-    private readonly DatabaseService _database;
-    public DatabaseModule(DatabaseService database)
-    {
-        _database = database;
-    }
-
-    [Command("read")]
-    public async Task ReadFromDbAsync()
-    {
-        await ReplyAsync(_database.GetData());
-    }
-}
-
-// Injection via public settable properties
-public class DatabaseModule : ModuleBase<SocketCommandContext>
-{
-    public DatabaseService DbService { get; set; }
-
-    [Command("read")]
-    public async Task ReadFromDbAsync()
-    {
-        await ReplyAsync(DbService.GetData());
-    }
-}

docs/guides/text_commands/samples/dependency-injection/dependency_module_noinject.cs

@@ -1,29 +0,0 @@
-// Sometimes injecting dependencies automatically with the provided
-// methods in the prior example may not be desired.
-
-// You may explicitly tell Discord.Net to **not** inject the properties
-// by either...
-// restricting the access modifier
-// -or-
-// applying DontInjectAttribute to the property
-
-// Restricting the access modifier of the property
-public class ImageModule : ModuleBase<SocketCommandContext>
-{
-    public ImageService ImageService { get; }
-    public ImageModule()
-    {
-        ImageService = new ImageService();
-    }
-}
-
-// Applying DontInjectAttribute
-public class ImageModule : ModuleBase<SocketCommandContext>
-{
-    [DontInject]
-    public ImageService ImageService { get; set; }
-    public ImageModule()
-    {
-        ImageService = new ImageService();
-    }
-}