meta: wipe everything

Discord.Net.code-workspace

@@ -1,23 +0,0 @@
-{
-	"folders": [
-		{
-			"path": "."
-		}
-	],
-	"settings": {
-		"editor.rulers": [
-			120
-		],
-		"files.exclude": {
-			"**/.git": true,
-			"**/.svn": true,
-			"**/.hg": true,
-			"**/CVS": true,
-			"**/.DS_Store": true,
-			"docs/": true,
-			"**/obj": true,
-			"**/bin": true,
-			"samples/": true,
-		}
-	}
-}

Discord.Net.sln

@@ -1,198 +0,0 @@
-Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 15
-VisualStudioVersion = 15.0.27004.2009
-MinimumVisualStudioVersion = 10.0.40219.1
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Core", "src\Discord.Net.Core\Discord.Net.Core.csproj", "{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Impls", "Impls", "{288C363D-A636-4EAE-9AC1-4698B641B26E}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Rest", "src\Discord.Net.Rest\Discord.Net.Rest.csproj", "{BFC6DC28-0351-4573-926A-D4124244C04F}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Commands", "src\Discord.Net.Commands\Discord.Net.Commands.csproj", "{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.WebSocket", "src\Discord.Net.WebSocket\Discord.Net.WebSocket.csproj", "{688FD1D8-7F01-4539-B2E9-F473C5D699C7}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Providers", "Providers", "{B0657AAE-DCC5-4FBF-8E5D-1FB578CF3012}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Providers.WS4Net", "src\Discord.Net.Providers.WS4Net\Discord.Net.Providers.WS4Net.csproj", "{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Extensions", "Extensions", "{CC3D4B1C-9DE0-448B-8AE7-F3F1F3EC5C3A}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Tests", "test\Discord.Net.Tests\Discord.Net.Tests.csproj", "{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Webhook", "src\Discord.Net.Webhook\Discord.Net.Webhook.csproj", "{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discord.Net.Analyzers", "src\Discord.Net.Analyzers\Discord.Net.Analyzers.csproj", "{BBA8E7FB-C834-40DC-822F-B112CB7F0140}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Samples", "Samples", "{BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "01_basic_ping_bot", "samples\01_basic_ping_bot\01_basic_ping_bot.csproj", "{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "02_commands_framework", "samples\02_commands_framework\02_commands_framework.csproj", "{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "03_sharded_client", "samples\03_sharded_client\03_sharded_client.csproj", "{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Any CPU = Debug|Any CPU
-		Debug|x64 = Debug|x64
-		Debug|x86 = Debug|x86
-		Release|Any CPU = Release|Any CPU
-		Release|x64 = Release|x64
-		Release|x86 = Release|x86
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Debug|x64.Build.0 = Debug|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Debug|x86.Build.0 = Debug|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Release|Any CPU.Build.0 = Release|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Release|x64.ActiveCfg = Release|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Release|x64.Build.0 = Release|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Release|x86.ActiveCfg = Release|Any CPU
-		{91E9E7BD-75C9-4E98-84AA-2C271922E5C2}.Release|x86.Build.0 = Release|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Debug|x64.Build.0 = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Debug|x86.Build.0 = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Release|Any CPU.Build.0 = Release|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Release|x64.ActiveCfg = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Release|x64.Build.0 = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Release|x86.ActiveCfg = Debug|Any CPU
-		{BFC6DC28-0351-4573-926A-D4124244C04F}.Release|x86.Build.0 = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Debug|x64.Build.0 = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Debug|x86.Build.0 = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Release|Any CPU.Build.0 = Release|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Release|x64.ActiveCfg = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Release|x64.Build.0 = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Release|x86.ActiveCfg = Debug|Any CPU
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C}.Release|x86.Build.0 = Debug|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Debug|x64.Build.0 = Debug|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Debug|x86.Build.0 = Debug|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Release|Any CPU.Build.0 = Release|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Release|x64.ActiveCfg = Release|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Release|x64.Build.0 = Release|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Release|x86.ActiveCfg = Release|Any CPU
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7}.Release|x86.Build.0 = Release|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Debug|x64.Build.0 = Debug|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Debug|x86.Build.0 = Debug|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Release|Any CPU.Build.0 = Release|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Release|x64.ActiveCfg = Release|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Release|x64.Build.0 = Release|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Release|x86.ActiveCfg = Release|Any CPU
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7}.Release|x86.Build.0 = Release|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Debug|x64.Build.0 = Debug|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Debug|x86.Build.0 = Debug|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Release|Any CPU.Build.0 = Release|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Release|x64.ActiveCfg = Release|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Release|x64.Build.0 = Release|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Release|x86.ActiveCfg = Release|Any CPU
-		{C38E5BC1-11CB-4101-8A38-5B40A1BC6433}.Release|x86.Build.0 = Release|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Debug|x64.Build.0 = Debug|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Debug|x86.Build.0 = Debug|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Release|Any CPU.Build.0 = Release|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Release|x64.ActiveCfg = Release|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Release|x64.Build.0 = Release|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Release|x86.ActiveCfg = Release|Any CPU
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30}.Release|x86.Build.0 = Release|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Debug|x64.Build.0 = Debug|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Debug|x86.Build.0 = Debug|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Release|Any CPU.Build.0 = Release|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Release|x64.ActiveCfg = Release|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Release|x64.Build.0 = Release|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Release|x86.ActiveCfg = Release|Any CPU
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140}.Release|x86.Build.0 = Release|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Debug|x64.Build.0 = Debug|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Debug|x86.Build.0 = Debug|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Release|Any CPU.Build.0 = Release|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Release|x64.ActiveCfg = Release|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Release|x64.Build.0 = Release|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Release|x86.ActiveCfg = Release|Any CPU
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E}.Release|x86.Build.0 = Release|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Debug|x64.Build.0 = Debug|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Debug|x86.Build.0 = Debug|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|Any CPU.Build.0 = Release|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|x64.ActiveCfg = Release|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|x64.Build.0 = Release|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|x86.ActiveCfg = Release|Any CPU
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76}.Release|x86.Build.0 = Release|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x64.ActiveCfg = Debug|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x64.Build.0 = Debug|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Debug|x86.Build.0 = Debug|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|Any CPU.Build.0 = Release|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x64.ActiveCfg = Release|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x64.Build.0 = Release|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x86.ActiveCfg = Release|Any CPU
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26}.Release|x86.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-	GlobalSection(NestedProjects) = preSolution
-		{BFC6DC28-0351-4573-926A-D4124244C04F} = {288C363D-A636-4EAE-9AC1-4698B641B26E}
-		{078DD7E6-943D-4D09-AFC2-D2BA58B76C9C} = {CC3D4B1C-9DE0-448B-8AE7-F3F1F3EC5C3A}
-		{688FD1D8-7F01-4539-B2E9-F473C5D699C7} = {288C363D-A636-4EAE-9AC1-4698B641B26E}
-		{6BDEEC08-417B-459F-9CA3-FF8BAB18CAC7} = {B0657AAE-DCC5-4FBF-8E5D-1FB578CF3012}
-		{9AFAB80E-D2D3-4EDB-B58C-BACA78D1EA30} = {CC3D4B1C-9DE0-448B-8AE7-F3F1F3EC5C3A}
-		{BBA8E7FB-C834-40DC-822F-B112CB7F0140} = {CC3D4B1C-9DE0-448B-8AE7-F3F1F3EC5C3A}
-		{F2FF84FB-F6AD-47E5-9EE5-18206CAE136E} = {BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}
-		{4E1F1F40-B1DD-40C9-A4B1-A2046A4C9C76} = {BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}
-		{9B4C4AFB-3D15-44C6-9E36-12ED625AAA26} = {BB59D5B5-E7B0-4BF4-8F82-D14431B2799B}
-	EndGlobalSection
-	GlobalSection(ExtensibilityGlobals) = postSolution
-		SolutionGuid = {D2404771-EEC8-45F2-9D71-F3373F6C1495}
-	EndGlobalSection
-	GlobalSection(CodealikeProperties) = postSolution
-		SolutionGuid = a45217b4-a401-4dbf-8654-34d2ec034cd9
-	EndGlobalSection
-EndGlobal

Discord.Net.sln.DotSettings

@@ -1,16 +0,0 @@
-<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Cacheable/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Downloader/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Emoji/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=libsodium/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=NSFW/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Ratelimit/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=seeked/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=sharded/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Spotify/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=unban/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=Uncache/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=webhook/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=webhooks/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=webhook_0027s/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=ZWSP/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>

Discord.Net.targets

@@ -1,26 +0,0 @@
-<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-    <PropertyGroup>
-        <VersionPrefix>2.0.2</VersionPrefix>
-        <VersionSuffix>dev</VersionSuffix>
-        <Authors>RogueException</Authors>
-        <PackageTags>discord;discordapp</PackageTags>
-        <PackageProjectUrl>https://github.com/RogueException/Discord.Net</PackageProjectUrl>
-        <PackageLicenseUrl>http://opensource.org/licenses/MIT</PackageLicenseUrl>
-        <PackageIconUrl>https://github.com/RogueException/Discord.Net/raw/dev/docs/marketing/logo/PackageLogo.png</PackageIconUrl>
-        <RepositoryType>git</RepositoryType>
-        <RepositoryUrl>git://github.com/RogueException/Discord.Net</RepositoryUrl>
-    </PropertyGroup>
-    <PropertyGroup Condition=" '$(BuildNumber)' == '' ">
-        <VersionSuffix Condition=" '$(VersionSuffix)' != ''">$(VersionSuffix)-dev</VersionSuffix>
-        <VersionSuffix Condition=" '$(VersionSuffix)' == ''">dev</VersionSuffix>
-    </PropertyGroup>
-    <PropertyGroup Condition=" '$(BuildNumber)' != '' And $(IsTagBuild) != 'true' ">
-        <VersionSuffix Condition=" '$(VersionSuffix)' != '' ">$(VersionSuffix)-$(BuildNumber)</VersionSuffix>
-        <VersionSuffix Condition=" '$(VersionSuffix)' == '' ">build-$(BuildNumber)</VersionSuffix>
-    </PropertyGroup>     
-    <PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
-        <NoWarn>$(NoWarn);CS1573;CS1591</NoWarn>
-        <WarningsAsErrors>true</WarningsAsErrors>
-        <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    </PropertyGroup>
-</Project>

appveyor.yml

@@ -1,94 +0,0 @@
-version: build-{build}
-branches:
-  only:
-  - dev
-image:
-- Visual Studio 2017
-- Ubuntu
-
-nuget:
-  disable_publish_on_pr: true
-pull_requests:
-  do_not_increment_build_number: true
-# Use the default clone_folder
-# Windows: C:\Projects\discord-net
-# Ubuntu: /home/appveyor/projects/discord-net
-cache: test/Discord.Net.Tests/cache.db
-
-environment:
-  DOTNET_CLI_TELEMETRY_OPTOUT: 1
-  DNET_TEST_TOKEN:
-    secure: l7h5e7UE7yRd70hAB97kjPiQpPOShwqoBbOzEAYQ+XBd/Pre5OA33IXa3uisdUeQJP/nPFhcOsI+yn7WpuFaoQ==
-  DNET_TEST_GUILDID: 273160668180381696
-init:
-- ps: $Env:BUILD = "$($Env:APPVEYOR_BUILD_NUMBER.PadLeft(5, "0"))"
-
-build_script:
-- ps: >-
-    if ($isLinux)
-    {
-      # AppVeyor Linux images do not have appveyor-retry, which retries the commands a few times
-      # until the command exits with code 0.
-      # So, this is done with a short script.
-      $code = 0
-      $counter = 0
-      do
-      {
-        dotnet restore Discord.Net.sln -v Minimal /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-        $code = $LASTEXITCODE
-        $counter++
-        if ($code -ne 0)
-        {
-          # Wait 5s before attempting to run again
-          Start-sleep -Seconds 5
-        }
-      }
-      until ($counter -eq 5 -or $code -eq 0)
-    }
-    else
-    {
-      appveyor-retry dotnet restore Discord.Net.sln -v Minimal /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-    }
-- ps: dotnet build Discord.Net.sln -c "Release" /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-after_build:
-- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Core\Discord.Net.Core.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
-- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Rest\Discord.Net.Rest.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
-- ps: if ($isWindows) { dotnet pack "src\Discord.Net.WebSocket\Discord.Net.WebSocket.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
-- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Commands\Discord.Net.Commands.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
-- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Webhook\Discord.Net.Webhook.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
-- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Providers.WS4Net\Discord.Net.Providers.WS4Net.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
-- ps: if ($isWindows) { dotnet pack "src\Discord.Net.Analyzers\Discord.Net.Analyzers.csproj" -c "Release" -o "../../artifacts" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG" }
-- ps: >-
-    if ($isWindows)
-    {
-      if ($Env:APPVEYOR_REPO_TAG -eq "true") {
-        nuget pack src/Discord.Net/Discord.Net.nuspec -OutputDirectory "artifacts" -properties suffix=""
-      } else {
-        nuget pack src/Discord.Net/Discord.Net.nuspec -OutputDirectory "artifacts" -properties suffix="-$Env:BUILD"
-      }
-    }
-- ps: if ($isWindows) { Get-ChildItem artifacts/*.nupkg | % { Push-AppveyorArtifact $_.FullName -FileName $_.Name } }
-
-test_script:
-- ps: >-
-    if ($APPVEYOR_PULL_REQUEST_NUMBER -eq "") {
-      dotnet test test/Discord.Net.Tests/Discord.Net.Tests.csproj -c "Release" --no-build /p:BuildNumber="$Env:BUILD" /p:IsTagBuild="$Env:APPVEYOR_REPO_TAG"
-    }
-
-deploy:
-- provider: NuGet
-  server: https://www.myget.org/F/discord-net/api/v2/package
-  api_key:
-    secure: Jl7BXeUjRnkVHDMBuUWSXcEOkrli1PBleW2IiLyUs5j63UNUNp1hcjaUJRujx9lz
-  symbol_server: https://www.myget.org/F/discord-net/symbols/api/v2/package
-  on:
-    branch: dev
-    CI_WINDOWS: true
-- provider: NuGet
-  server: https://www.myget.org/F/rogueexception/api/v2/package
-  api_key:
-    secure: D+vW2O2LBf/iJb4f+q8fkyIW2VdIYIGxSYLWNrOD4BHlDBZQlJipDbNarWjUr2Kn
-  symbol_server: https://www.myget.org/F/rogueexception/symbols/api/v2/package
-  on:
-    branch: dev
-    CI_WINDOWS: true

docs/.gitignore

@@ -1,10 +0,0 @@
-
-###############
-#    folder   #
-###############
-/**/DROP/
-/**/TEMP/
-/**/packages/
-/**/bin/
-/**/obj/
-_site

docs/CONTRIBUTING.md

@@ -1,35 +0,0 @@
-# Contributing to Docs
-
-## General Guidelines
-
-We do not have any strict conditions for writing documentation,
-but keep these guidelines in mind:
-
-* Keep code samples in the `guides/samples` folder
-* When referencing an object in the API, link to its page in the
- API documentation
-* Documentation should be written in an FAQ/Wiki-style format
-* Documentation should be written in clear and proper English*
-
-\* If anyone is interested in translating documentation into other
-languages, please open an issue or contact me on
-Discord (`foxbot#0282`).
-
-## Style Consistencies
-
-* Use a ruler set at 70 characters
-* Links should use long syntax
-* Pages should be short and concise, not broad and long
-
-Example of long link syntax:
-
-```md
-Please consult the [API Documentation] for more information.
-
-[API Documentation]: xref:System.String
-```
-
-## Recommended Reads
-
-* http://docs.microsoft.com
-* http://flask.pocoo.org/docs/0.12/

docs/Discord.Net.Docs.code-workspace

@@ -1,21 +0,0 @@
-{
-	"folders": [
-		{
-			"path": "."
-		}
-	],
-	"settings": {
-		"editor.rulers": [
-			70
-		],
-		"files.exclude": {
-			"**/.git": true,
-			"**/.svn": true,
-			"**/.hg": true,
-			"**/CVS": true,
-			"**/.DS_Store": true,
-			"obj/": true,
-			"_site/": true,
-		}
-	}
-}

docs/README.md

@@ -1,15 +0,0 @@
-# Instructions for Building Documentation
-
-The documentation for the Discord.Net library uses [DocFX][docfx-main].
-Instructions for installing this tool can be found [here][docfx-installing].
-
-1. Navigate to the root of the repository.
-2. Build the docs using `docfx docs/docfx.json`. Add the `--serve`
- parameter to preview the site locally. Some elements of the page
- may appear incorrectly when hosted offline.
-
-Please note that if you intend to target a specific version, ensure
-that you have the correct version checked out.
-
-[docfx-main]: https://dotnet.github.io/docfx/
-[docfx-installing]: https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html

docs/_overwrites/Commands/CommandException.Overwrite.md

@@ -1,31 +0,0 @@
----
-uid: Discord.Commands.CommandException
-remarks: *content
----
-
-This @System.Exception class is typically used when diagnosing
-an error thrown during the execution of a command. You will find the
-thrown exception passed into
-[LogMessage.Exception](xref:Discord.LogMessage.Exception), which is
-sent to your [CommandService.Log](xref:Discord.Commands.CommandService.Log)
-event handler.
-
----
-uid: Discord.Commands.CommandException
-example: [*content]
----
-
-You may use this information to handle runtime exceptions after
-execution. Below is an example of how you may use this:
-
-```cs
-public Task LogHandlerAsync(LogMessage logMessage)
-{
-    // Note that this casting method requires C#7 and up.
-    if (logMessage?.Exception is CommandException cmdEx)
-    {
-        Console.WriteLine($"{cmdEx.GetBaseException().GetType()} was thrown while executing {cmdEx.Command.Aliases.First()} in {cmdEx.Context.Channel} by {cmdEx.Context.User}.");
-    }
-    return Task.CompletedTask;
-}
-```

docs/_overwrites/Commands/DontAutoLoadAttribute.Overwrite.md

@@ -1,22 +0,0 @@
----
-uid: Discord.Commands.DontAutoLoadAttribute
-remarks: *content
----
-
-The attribute can be applied to a public class that inherits
-@Discord.Commands.ModuleBase. By applying this attribute,
-@Discord.Commands.CommandService.AddModulesAsync* will not discover and
-add the marked module to the CommandService.
-
----
-uid: Discord.Commands.DontAutoLoadAttribute
-example: [*content]
----
-
-```cs
-[DontAutoLoad]
-public class MyModule : ModuleBase<SocketCommandContext>
-{
-    // ...
-}
-```

docs/_overwrites/Commands/DontInjectAttribute.Overwrite.md

@@ -1,27 +0,0 @@
----
-uid: Discord.Commands.DontInjectAttribute
-remarks: *content
----
-
-The attribute can be applied to a public settable property inside a
-@Discord.Commands.ModuleBase based class. By applying this attribute,
-the marked property will not be automatically injected of the
-dependency. See @Guides.Commands.DI to learn more.
-
----
-uid: Discord.Commands.DontInjectAttribute
-example: [*content]
----
-
-```cs
-public class MyModule : ModuleBase<SocketCommandContext>
-{
-    [DontInject]
-    public MyService MyService { get; set; }
-
-    public MyModule()
-    {
-        MyService = new MyService();
-    }
-}
-```

docs/_overwrites/Commands/ICommandContext.Inclusion.md

@@ -1,5 +0,0 @@
-An example of how this class is used the command system can be seen 
-below:
-
-[!code[Sample module](../../guides/commands/samples/intro/empty-module.cs)]
-[!code[Command handler](../../guides/commands/samples/intro/command_handler.cs)]

docs/_overwrites/Commands/ICommandContext.Overwrite.md

@@ -1,27 +0,0 @@
----
-uid: Discord.Commands.ICommandContext
-example: [*content]
----
-
-[!include[Example Section](ICommandContext.Inclusion.md)]
-
----
-uid: Discord.Commands.CommandContext
-example: [*content]
----
-
-[!include[Example Section](ICommandContext.Inclusion.md)]
-
----
-uid: Discord.Commands.SocketCommandContext
-example: [*content]
----
-
-[!include[Example Section](ICommandContext.Inclusion.md)]
-
----
-uid: Discord.Commands.ShardCommandContext
-example: [*content]
----
-
-[!include[Example Section](ICommandContext.Inclusion.md)]

docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md

@@ -1,103 +0,0 @@
----
-uid: Discord.Commands.PreconditionAttribute
-remarks: *content
----
-
-This precondition attribute can be applied on module-level or
-method-level for a command.
-
-[!include[Additional Remarks](PreconditionAttribute.Remarks.Inclusion.md)]
-
----
-uid: Discord.Commands.ParameterPreconditionAttribute
-remarks: *content
----
-
-This precondition attribute can be applied on parameter-level for a
-command.
-
-[!include[Additional Remarks](PreconditionAttribute.Remarks.Inclusion.md)]
-
----
-uid: Discord.Commands.PreconditionAttribute
-example: [*content]
----
-
-The following example creates a precondition to see if the user has
-sufficient role required to access the command.
-
-```cs
-public class RequireRoleAttribute : PreconditionAttribute
-{
-    private readonly ulong _roleId;
-
-    public RequireRoleAttribute(ulong roleId)
-    {
-        _roleId = roleId;
-    }
-
-    public override async Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context,
-        CommandInfo command, IServiceProvider services)
-    {
-        var guildUser = context.User as IGuildUser;
-        if (guildUser == null)
-            return PreconditionResult.FromError("This command cannot be executed outside of a guild.");
-
-        var guild = guildUser.Guild;
-        if (guild.Roles.All(r => r.Id != _roleId))
-            return PreconditionResult.FromError(
-                $"The guild does not have the role ({_roleId}) required to access this command.");
-
-        return guildUser.RoleIds.Any(rId => rId == _roleId)
-            ? PreconditionResult.FromSuccess()
-            : PreconditionResult.FromError("You do not have the sufficient role required to access this command.");
-    }
-}
-```
-
----
-uid: Discord.Commands.ParameterPreconditionAttribute
-example: [*content]
----
-
-The following example creates a precondition on a parameter-level to
-see if the targeted user has a lower hierarchy than the user who
-executed the command.
-
-```cs
-public class RequireHierarchyAttribute : ParameterPreconditionAttribute
-{
-    public override async Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context,
-        ParameterInfo parameter, object value, IServiceProvider services)
-    {
-        // Hierarchy is only available under the socket variant of the user.
-        if (!(context.User is SocketGuildUser guildUser))
-            return PreconditionResult.FromError("This command cannot be used outside of a guild.");
-
-        SocketGuildUser targetUser;
-        switch (value)
-        {
-            case SocketGuildUser targetGuildUser:
-                targetUser = targetGuildUser;
-                break;
-            case ulong userId:
-                targetUser = await context.Guild.GetUserAsync(userId).ConfigureAwait(false) as SocketGuildUser;
-                break;
-            default:
-                throw new ArgumentOutOfRangeException();
-        }
-
-        if (targetUser == null)
-            return PreconditionResult.FromError("Target user not found.");
-
-        if (guildUser.Hierarchy < targetUser.Hierarchy)
-            return PreconditionResult.FromError("You cannot target anyone else whose roles are higher than yours.");
-
-        var currentUser = await context.Guild.GetCurrentUserAsync().ConfigureAwait(false) as SocketGuildUser;
-        if (currentUser?.Hierarchy < targetUser.Hierarchy)
-            return PreconditionResult.FromError("The bot's role is lower than the targeted user.");
-
-        return PreconditionResult.FromSuccess();
-    }
-}
-```

docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md

@@ -1,6 +0,0 @@
-A "precondidtion" in the command system is used to determine if a
-condition is met before entering the command task. Using a
-precondidtion may aid in keeping a well-organized command logic.
-
-The most common use case being whether a user has sufficient
-permission to execute the command.

docs/_overwrites/Common/EmbedBuilder.Overwrites.md

@@ -1,68 +0,0 @@
----
-uid: Discord.EmbedBuilder
-seealso:
-    - linkId: Discord.EmbedFooterBuilder
-    - linkId: Discord.EmbedAuthorBuilder
-    - linkId: Discord.EmbedFieldBuilder
-remarks: *content
----
-
-This builder class is used to build an @Discord.Embed (rich embed)
-object that will be ready to be sent via @Discord.IMessageChannel.SendMessageAsync*
-after @Discord.EmbedBuilder.Build* is called.
-
----
-uid: Discord.EmbedBuilder
-example: [*content]
----
-
-#### Basic Usage
-
-The example below builds an embed and sends it to the chat using the
-command system.
-
-```cs
-[Command("embed")]
-public async Task SendRichEmbedAsync()
-{
-    var embed = new EmbedBuilder
-        {
-            // Embed property can be set within object initializer
-            Title = "Hello world!"
-            Description = "I am a description set by initializer."
-        };
-        // Or with methods
-    embed.AddField("Field title",
-        "Field value. I also support [hyperlink markdown](https://example.com)!")
-        .WithAuthor(Context.Client.CurrentUser)
-        .WithFooter(footer => footer.Text = "I am a footer.")
-        .WithColor(Color.Blue)
-        .WithTitle("I overwrote \"Hello world!\"")
-        .WithDescription("I am a description.")
-        .WithUrl("https://example.com")
-        .WithCurrentTimestamp()
-        .Build();
-    await ReplyAsync(embed: embed);
-}
-```
-
-![Embed Example](images/embed-example.png)
-
-#### Usage with Local Images
-
-The example below sends an image and has the image embedded in the rich
-embed. See @Discord.IMessageChannel.SendFileAsync* for more information
-about uploading a file or image.
-
-```cs
-[Command("embedimage")]
-public async Task SendEmbedWithImageAsync()
-{
-    var fileName = "image.png";
-    var embed = new EmbedBuilder()
-        {
-            ImageUrl = $"attachment://{fileName}"
-        }.Build();
-    await Context.Channel.SendFileAsync(fileName, embed: embed);
-}
-```

docs/_overwrites/Common/EmbedObjectBuilder.Inclusion.md

@@ -1,25 +0,0 @@
-The example will build a rich embed with an author field, a footer
-field, and 2 normal fields using an @Discord.EmbedBuilder:
-
-```cs
-var exampleAuthor = new EmbedAuthorBuilder()
-        .WithName("I am a bot")
-        .WithIconUrl("https://discordapp.com/assets/e05ead6e6ebc08df9291738d0aa6986d.png");
-var exampleFooter = new EmbedFooterBuilder()
-        .WithText("I am a nice footer")
-        .WithIconUrl("https://discordapp.com/assets/28174a34e77bb5e5310ced9f95cb480b.png");
-var exampleField = new EmbedFieldBuilder()
-        .WithName("Title of Another Field")
-        .WithValue("I am an [example](https://example.com).")
-        .WithInline(true);
-var otherField = new EmbedFieldBuilder()
-        .WithName("Title of a Field")
-        .WithValue("Notice how I'm inline with that other field next to me.")
-        .WithInline(true);
-var embed = new EmbedBuilder()
-        .AddField(exampleField)
-        .AddField(otherField)
-        .WithAuthor(exampleAuthor)
-        .WithFooter(exampleFooter)
-        .Build();
-```

docs/_overwrites/Common/EmbedObjectBuilder.Overwrites.md

@@ -1,20 +0,0 @@
----
-uid: Discord.EmbedAuthorBuilder
-example: [*content]
----
-
-[!include[Embed Object Builder Sample](EmbedObjectBuilder.Inclusion.md)]
-
----
-uid: Discord.EmbedFooterBuilder
-example: [*content]
----
-
-[!include[Embed Object Builder Sample](EmbedObjectBuilder.Inclusion.md)]
-
----
-uid: Discord.EmbedFieldBuilder
-example: [*content]
----
-
-[!include[Embed Object Builder Sample](EmbedObjectBuilder.Inclusion.md)]

docs/_overwrites/Common/IEmote.Inclusion.md

@@ -1,26 +0,0 @@
-The sample below sends a message and adds an @Discord.Emoji and a custom
-@Discord.Emote to the message.
-
-```cs
-public async Task SendAndReactAsync(ISocketMessageChannel channel)
-{
-    var message = await channel.SendMessageAsync("I am a message.");
-
-    // Creates a Unicode-based emoji based on the Unicode string.
-    // This is effectively the same as new Emoji("💕").
-    var heartEmoji = new Emoji("\U0001f495");
-    // Reacts to the message with the Emoji.
-    await message.AddReactionAsync(heartEmoji);
-
-    // Parses a custom emote based on the provided Discord emote format.
-    // Please note that this does not guarantee the existence of
-    // the emote.
-    var emote = Emote.Parse("<:thonkang:282745590985523200>");
-    // Reacts to the message with the Emote.
-    await message.AddReactionAsync(emote);
-}
-```
-
-#### Result
-
-![React Example](images/react-example.png)

docs/_overwrites/Common/IEmote.Overwrites.md

@@ -1,81 +0,0 @@
----
-uid: Discord.IEmote
-seealso:
-    - linkId: Discord.Emote
-    - linkId: Discord.Emoji
-    - linkId: Discord.GuildEmote
-    - linkId: Discord.IUserMessage
-remarks: *content
----
-
-This interface is often used with reactions. It can represent an
-unicode-based @Discord.Emoji, or a custom @Discord.Emote.
-
----
-uid: Discord.Emote
-seealso:
-    - linkId: Discord.IEmote
-    - linkId: Discord.GuildEmote
-    - linkId: Discord.Emoji
-    - linkId: Discord.IUserMessage
-remarks: *content
----
-
-> [!NOTE]
-> A valid @Discord.Emote format is `<:emoteName:emoteId>`. This can be
-> obtained by escaping with a `\` in front of the emote using the
-> Discord chat client.
-
-This class represents a custom emoji. This type of emoji can be
-created via the @Discord.Emote.Parse* or @Discord.Emote.TryParse*
-method.
-
----
-uid: Discord.Emoji
-seealso:
-    - linkId: Discord.Emote
-    - linkId: Discord.GuildEmote
-    - linkId: Discord.Emoji
-    - linkId: Discord.IUserMessage
-remarks: *content
----
-
-> [!NOTE]
-> A valid @Discord.Emoji format is Unicode-based. This means only
-> something like `🙃` or `\U0001f643` would work, instead of
-> `:upside_down:`.
->
-> A Unicode-based emoji can be obtained by escaping with a `\` in
-> front of the emote using the Discord chat client or by looking up on
-> [Emojipedia](https://emojipedia.org).
-
-This class represents a standard Unicode-based emoji. This type of emoji
-can be created by passing the Unicode into the constructor.
-
----
-uid: Discord.IEmote
-example: [*content]
----
-
-[!include[Example Section](IEmote.Inclusion.md)]
-
----
-uid: Discord.Emoji
-example: [*content]
----
-
-[!include[Example Section](IEmote.Inclusion.md)]
-
----
-uid: Discord.Emote
-example: [*content]
----
-
-[!include[Example Section](IEmote.Inclusion.md)]
-
----
-uid: Discord.GuildEmote
-example: [*content]
----
-
-[!include[Example Section](IEmote.Inclusion.md)]

docs/_overwrites/Common/ObjectProperties.Overwrites.md

@@ -1,174 +0,0 @@
----
-uid: Discord.GuildChannelProperties
-example: [*content]
----
-
-The following example uses @Discord.IGuildChannel.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-var channel = _client.GetChannel(id) as IGuildChannel;
-if (channel == null) return;
-
-await channel.ModifyAsync(x =>
-{
-    x.Name = "new-name";
-    x.Position = channel.Position - 1;
-});
-```
-
----
-uid: Discord.TextChannelProperties
-example: [*content]
----
-
-The following example uses @Discord.ITextChannel.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-var channel = _client.GetChannel(id) as ITextChannel;
-if (channel == null) return;
-
-await channel.ModifyAsync(x =>
-{
-    x.Name = "cool-guys-only";
-    x.Topic = "This channel is only for cool guys and adults!!!";
-    x.Position = channel.Position - 1;
-    x.IsNsfw = true;
-});
-```
-
----
-uid: Discord.VoiceChannelProperties
-example: [*content]
----
-
-The following example uses @Discord.IVoiceChannel.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-var channel = _client.GetChannel(id) as IVoiceChannel;
-if (channel == null) return;
-
-await channel.ModifyAsync(x =>
-{
-    x.UserLimit = 5;
-});
-```
-
----
-uid: Discord.EmoteProperties
-example: [*content]
----
-
-The following example uses @Discord.IGuild.ModifyEmoteAsync* to
-apply changes specified in the properties,
-
-```cs
-await guild.ModifyEmoteAsync(x =>
-{
-    x.Name = "blobo";
-});
-```
-
----
-uid: Discord.MessageProperties
-example: [*content]
----
-
-The following example uses @Discord.IUserMessage.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-var message = await channel.SendMessageAsync("boo");
-await Task.Delay(TimeSpan.FromSeconds(1));
-await message.ModifyAsync(x => x.Content = "boi");
-```
-
----
-uid: Discord.GuildProperties
-example: [*content]
----
-
-The following example uses @Discord.IGuild.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-var guild = _client.GetGuild(id);
-if (guild == null) return;
-
-await guild.ModifyAsync(x =>
-{
-    x.Name = "VERY Fast Discord Running at Incredible Hihg Speed";
-});
-```
-
----
-uid: Discord.RoleProperties
-example: [*content]
----
-
-The following example uses @Discord.IRole.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-var role = guild.GetRole(id);
-if (role == null) return;
-
-await role.ModifyAsync(x =>
-{
-    x.Name = "cool boi";
-    x.Color = Color.Gold;
-    x.Hoist = true;
-    x.Mentionable = true;
-});
-```
-
----
-uid: Discord.GuildUserProperties
-example: [*content]
----
-
-The following example uses @Discord.IGuildUser.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-var user = guild.GetUser(id);
-if (user == null) return;
-
-await user.ModifyAsync(x =>
-{
-    x.Nickname = "I need healing";
-});
-```
-
----
-uid: Discord.SelfUserProperties
-example: [*content]
----
-
-The following example uses @Discord.ISelfUser.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-await selfUser.ModifyAsync(x =>
-{
-    x.Username = "Mercy";
-});
-```
-
----
-uid: Discord.WebhookProperties
-example: [*content]
----
-
-The following example uses @Discord.IWebhook.ModifyAsync* to
-apply changes specified in the properties,
-
-```cs
-await webhook.ModifyAsync(x =>
-{
-    x.Name = "very fast fox";
-    x.ChannelId = newChannelId;
-});
-```

docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md

@@ -1,24 +0,0 @@
----
-uid: Discord.Commands.OverrideTypeReaderAttribute
-remarks: *content
----
-
-This attribute is used to override a command parameter's type reading
-behaviour. This may be useful when you have multiple custom
-@Discord.Commands.TypeReader and would like to specify one.
-
----
-uid: Discord.Commands.OverrideTypeReaderAttribute
-examples: [*content]
----
-
-The following example will override the @Discord.Commands.TypeReader
-of @Discord.IUser to `MyUserTypeReader`.
-
-```cs
-public async Task PrintUserAsync(
-    [OverrideTypeReader(typeof(MyUserTypeReader))] IUser user)
-{
-    //...
-}
-```

docs/_template/description-generator/plugins/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2018 Still Hsu
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

docs/_template/last-modified/plugins/LICENSE

@@ -1,29 +0,0 @@
-MIT License
-
-Copyright (c) 2018 Still Hsu
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-==============================================================================
-
-Humanizer (https://github.com/Humanizr/Humanizer)
-The MIT License (MIT)
-Copyright (c) .NET Foundation and Contributors
-
-==============================================================================

docs/_template/last-modified/plugins/LibGit2Sharp.dll.config

@@ -1,4 +0,0 @@
-<configuration>
-    <dllmap os="linux" cpu="x86-64" wordsize="64" dll="git2-8e0b172" target="lib/linux-x64/libgit2-8e0b172.so" />
-    <dllmap os="osx" cpu="x86,x86-64" dll="git2-8e0b172" target="lib/osx/libgit2-8e0b172.dylib" />
-</configuration>

docs/_template/light-dark-theme/partials/affix.tmpl.partial

@@ -1,33 +0,0 @@
-{{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root for full license information.}}
-
-<div class="hidden-sm col-md-2" role="complementary">
-  <div class="sideaffix">
-    <div class="theme-switch-field">
-      <p>Theme</p>
-      <select id="theme-switcher">
-        <option value="dark">Dark</option>
-        <option value="gray">Gray</option>
-        <option value="light">Light</option>
-      </select>
-    </div>
-    {{^_disableContribution}}
-    <div class="contribution">
-      <ul class="nav">
-        {{#docurl}}
-        <li>
-          <a href="{{docurl}}" class="contribution-link">{{__global.improveThisDoc}}</a>
-        </li>
-        {{/docurl}}
-        {{#sourceurl}}
-        <li>
-          <a href="{{sourceurl}}" class="contribution-link">{{__global.viewSource}}</a>
-        </li>
-        {{/sourceurl}}
-      </ul>
-    </div>
-    {{/_disableContribution}}
-    <nav class="bs-docs-sidebar hidden-print hidden-xs hidden-sm affix" id="affix">
-    <!-- <p><a class="back-to-top" href="#top">Back to top</a><p> -->
-    </nav>
-  </div>
-</div>

docs/_template/light-dark-theme/partials/head.tmpl.partial

@@ -1,27 +0,0 @@
-{{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root for full license information.}}
-
-<head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
-  <title>{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}</title>
-  <meta name="viewport" content="width=device-width">
-  <meta name="title" content="{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}">
-  <meta name="generator" content="docfx {{_docfxVersion}}">
-  {{#_description}}<meta name="description" content="{{_description}}">{{/_description}}
-  <link rel="preload" href="{{_rel}}styles/search-worker.js" as="script">
-  <link rel="preload" href="{{_rel}}fonts/glyphicons-halflings-regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
-  <link rel="shortcut icon" href="{{_rel}}{{{_appFaviconPath}}}{{^_appFaviconPath}}favicon.ico{{/_appFaviconPath}}">
-  <link rel="stylesheet" href="{{_rel}}styles/docfx.vendor.minify.css">
-  <link rel="stylesheet" href="{{_rel}}styles/docfx.css">
-  <link rel="stylesheet" href="{{_rel}}styles/master.css">
-  <link rel="stylesheet" href="{{_rel}}styles/main.css">
-  <link rel="stylesheet" href="{{_rel}}styles/theme-switcher.css">
-  <link href="https://cdn.rawgit.com/noelboss/featherlight/1.7.6/release/featherlight.min.css" type="text/css" rel="stylesheet" />
-  <meta name="theme-color" content="#99AAB5"/>
-  <meta property="docfx:navrel" content="{{_navRel}}">
-  <meta property="docfx:tocrel" content="{{_tocRel}}">
-  <meta id="docfx-style:rel" content="{{_rel}}">
-  {{#_noindex}}<meta name="searchOption" content="noindex">{{/_noindex}}
-  {{#_enableSearch}}<meta property="docfx:rel" content="{{_rel}}">{{/_enableSearch}}
-  {{#_enableNewTab}}<meta property="docfx:newtab" content="true">{{/_enableNewTab}}
-</head>

docs/_template/light-dark-theme/partials/scripts.tmpl.partial

@@ -1,10 +0,0 @@
-{{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root for full license information.}}
-
-<script type="text/javascript" src="{{_rel}}styles/docfx.vendor.js"></script>
-<script type="text/javascript" src="{{_rel}}styles/docfx.js"></script>
-<script type="text/javascript" src="{{_rel}}styles/main.js"></script>
-<script type="text/javascript" src="https://cdn.rawgit.com/noelboss/featherlight/master/release/featherlight.min.js" charset="utf-8"></script>
-<script type="text/javascript" src="{{_rel}}styles/plugin-featherlight.js"></script>
-<script type="text/javascript" src="{{_rel}}styles/styleswitcher.js"></script>
-<script type="text/javascript" src="https://malsup.github.io/jquery.corner.js"></script>
-<script type="text/javascript" src="{{_rel}}styles/cornerify.js"></script>

docs/_template/light-dark-theme/styles/cornerify.js

@@ -1,3 +0,0 @@
-window.onload = function (e) {
-    $('img').corner();
-}

docs/_template/light-dark-theme/styles/dark.css

@@ -1,308 +0,0 @@
-/* Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License. See License.txt in the project root for license information. */
-
-@import url('vs2015.css');
-html,
-body {
-    background: #212121;
-    color: #C0C0C0;
-}
-
-button,
-a {
-    color: #64B5F6;
-}
-
-.sidenav{
-  background-color: rgb(30, 30, 30);
-}
-
-button:hover,
-button:focus,
-a:hover,
-a:focus,
-.btn:focus,
-.btn:hover{
-    color: #2196F3;
-}
-
-a.disable,
-a.disable:hover {
-    color: #EEEEEE;
-}
-
-.divider {
-    color: #37474F;
-}
-
-hr {
-    border-color: #37474F;
-}
-
-.subnav {
-    background: #383838
-}
-
-.inheritance h5,
-.inheritedMembers h5 {
-    border-bottom: 1px solid #37474F;
-}
-
-article h4 {
-    border-bottom: 1px solid #37474F;
-}
-
-.docs-search {
-    background: #424242;
-}
-
-.search-results-group-heading {
-    color: #424242;
-}
-
-.search-close {
-    color: #424242;
-}
-
-.sidetoc {
-    background-color: #1b1b1b;
-    border-left: 0px solid #37474F;
-    border-right: 0px solid #37474F;
-}
-
-.sideaffix {
-    overflow: visible;
-}
-
-.sideaffix>div.contribution>ul>li>a.contribution-link:hover {
-    background-color: #333333;
-}
-
-/* toc */
-
-.toc .nav>li>a {
-    color: rgb(218, 218, 218);
-}
-
-.toc .nav>li>a:hover,
-.toc .nav>li>a:focus {
-    color: #E0E0E0;
-}
-
-.toc .nav>li.active>a {
-    color: #90CAF9;
-}
-
-.toc .nav>li.active>a:hover,
-.toc .nav>li.active>a:focus {
-    background-color: #37474F;
-    color: #4FC3F7;
-}
-
-.sidefilter {
-    background-color: #1b1b1b;
-    border-left: 0px solid #37474F;
-    border-right: 0px solid #37474F;
-}
-
-.affix ul>li>a:hover {
-    background: none;
-    color: #EEEEEE;
-}
-
-.affix ul>li.active>a,
-.affix ul>li.active>a:before {
-    color: #B3E5FC;
-}
-
-.affix ul>li>a {
-    color: #EEEEEE;
-}
-
-.affix>ul>li.active>a,
-.affix>ul>li.active>a:before {
-    color: #B3E5FC;
-}
-
-.tryspan {
-    border-color: #37474F;
-}
-
-.footer {
-    border-top: 1px solid #5F5F5F;
-    background: #616161;
-}
-
-/* alert */
-.alert-info {
-    color: #d9edf7;
-    background: #004458;
-    border-color: #005873;
-}
-
-.alert-warning {
-    color: #fffaf2;
-    background: #80551a;
-    border-color: #99661f;
-}
-
-.alert-danger {
-    color: #fff2f2;
-    background: #4d0000;
-    border-color: #660000;
-}
-
-/* For tabbed content */
-
-.tabGroup {
-    margin-top: 1rem;
-}
-
-.tabGroup ul[role="tablist"] {
-    margin: 0;
-    padding: 0;
-    list-style: none;
-}
-
-.tabGroup ul[role="tablist"]>li {
-    list-style: none;
-    display: inline-block;
-}
-
-.tabGroup a[role="tab"] {
-    color: white;
-    box-sizing: border-box;
-    display: inline-block;
-    padding: 5px 7.5px;
-    text-decoration: none;
-    border-bottom: 2px solid #fff;
-}
-
-.tabGroup a[role="tab"]:hover,
-.tabGroup a[role="tab"]:focus,
-.tabGroup a[role="tab"][aria-selected="true"] {
-    border-bottom: 2px solid #607D8B;
-}
-
-.tabGroup a[role="tab"][aria-selected="true"] {
-    color: #81D4FA;
-}
-
-.tabGroup a[role="tab"]:hover,
-.tabGroup a[role="tab"]:focus {
-    color: #29B6F6;
-}
-
-.tabGroup a[role="tab"]:focus {
-    outline: 1px solid #607D8B;
-    outline-offset: -1px;
-}
-
-@media (min-width: 768px) {
-    .tabGroup a[role="tab"] {
-        padding: 5px 15px;
-    }
-}
-
-.tabGroup section[role="tabpanel"] {
-    border: 1px solid #607D8B;
-    padding: 15px;
-    margin: 0;
-    overflow: hidden;
-}
-
-.tabGroup section[role="tabpanel"]>.codeHeader,
-.tabGroup section[role="tabpanel"]>pre {
-    margin-left: -16px;
-    margin-right: -16px;
-}
-
-.tabGroup section[role="tabpanel"]> :first-child {
-    margin-top: 0;
-}
-
-.tabGroup section[role="tabpanel"]>pre:last-child {
-    display: block;
-    margin-bottom: -16px;
-}
-
-.mainContainer[dir='rtl'] main ul[role="tablist"] {
-    margin: 0;
-}
-
-/* code */
-
-code {
-    color: white;
-    background-color: #4a4c52;
-    border-radius: 4px;
-    padding: 3px 7px;
-}
-
-pre {
-    background-color: #282a36;
-}
-
-/* table */
-
-.table-striped>tbody>tr:nth-of-type(odd) {
-    background-color: #333333;
-    color: #d3d3d3
-}
-
-tbody>tr {
-    background-color: #424242;
-    color: #c0c0c0
-}
-
-.table>tbody+tbody {
-    border-top: 2px solid rgb(173, 173, 173)
-}
-
-/* select */
-
-select {
-    background-color: #3b3b3b;
-    border-color: #2e2e2e;
-}
-
-/* 
-    Following code regarding collapse container are fetched 
-    or modified from the Materialize project.
-
-    The MIT License (MIT)
-    Copyright (c) 2014-2018 Materialize
-    https://github.com/Dogfalo/materialize
-*/
-
-/* all collapse container */
-.collapse-container.last-modified {
-    -webkit-box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
-    box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
-    border-top: 1px solid rgba(96, 96, 96, 0.7);
-    border-right: 1px solid rgba(96, 96, 96, 0.7);
-    border-left: 1px solid rgba(96, 96, 96, 0.7);
-}
-
-/* header */
-.collapse-container.last-modified>:nth-child(odd) {
-    background-color: #3f3f3f;
-    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
-}
-
-/* body */
-.collapse-container.last-modified>:nth-child(even) {
-    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
-    background-color: inherit;
-}
-
-span.arrow-d{
-    border-top: 5px solid white
-}
-
-span.arrow-r{
-    border-left: 5px solid white
-}
-
-.logo-switcher {
-    background: url("/marketing/logo/SVG/Combinationmark White.svg") no-repeat;
-}

docs/_template/light-dark-theme/styles/gray.css

@@ -1,315 +0,0 @@
-/* Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License. See License.txt in the project root for license information. */
-
-@import url('vs2015.css');
-html,
-body {
-    background: #23272A;
-    color: #dddddd;
-}
-
-button,
-a {
-    color: #64B5F6;
-}
-
-.sidenav{
-  background-color: rgb(30, 30, 30);
-}
-
-button:hover,
-button:focus,
-a:hover,
-a:focus,
-.btn:focus,
-.btn:hover{
-    color: #2196F3;
-}
-
-a.disable,
-a.disable:hover {
-    color: #EEEEEE;
-}
-
-.divider {
-    color: #37474F;
-}
-
-hr {
-    border-color: #37474F;
-}
-
-/* top navbar */
-.navbar-inverse[role="navigation"] {
-    background-color: #2C2F33;
-}
-
-/* sub navbar (below top) */
-.subnav {
-    background: #282B2F
-}
-
-
-.inheritance h5,
-.inheritedMembers h5 {
-    border-bottom: 1px solid #37474F;
-}
-
-article h4 {
-    border-bottom: 1px solid #37474F;
-}
-
-.docs-search {
-    background: #424242;
-}
-
-.search-results-group-heading {
-    color: #424242;
-}
-
-.search-close {
-    color: #424242;
-}
-
-.sidetoc {
-    background-color: #1b1b1b;
-    border-left: 0px solid #37474F;
-    border-right: 0px solid #37474F;
-}
-
-.sideaffix {
-    overflow: visible;
-}
-
-.sideaffix>div.contribution>ul>li>a.contribution-link:hover {
-    background-color: #333333;
-}
-
-/* toc */
-
-.toc .nav>li>a {
-    color: rgb(218, 218, 218);
-}
-
-.toc .nav>li>a:hover,
-.toc .nav>li>a:focus {
-    color: #E0E0E0;
-}
-
-.toc .nav>li.active>a {
-    color: #90CAF9;
-}
-
-.toc .nav>li.active>a:hover,
-.toc .nav>li.active>a:focus {
-    background-color: #37474F;
-    color: #4FC3F7;
-}
-
-.sidefilter {
-    background-color: #1b1b1b;
-    border-left: 0px solid #37474F;
-    border-right: 0px solid #37474F;
-}
-
-.affix ul>li>a:hover {
-    background: none;
-    color: #EEEEEE;
-}
-
-.affix ul>li.active>a,
-.affix ul>li.active>a:before {
-    color: #B3E5FC;
-}
-
-.affix ul>li>a {
-    color: #EEEEEE;
-}
-
-.affix>ul>li.active>a,
-.affix>ul>li.active>a:before {
-    color: #B3E5FC;
-}
-
-.tryspan {
-    border-color: #37474F;
-}
-
-.footer {
-    border-top: 1px solid #5F5F5F;
-    background: #2C2F33;
-}
-
-/* alert */
-.alert-info {
-    color: #f3fdff;
-    background: #40788A;
-    border-color: #2F7A95;
-}
-
-.alert-warning {
-    color: #fffaf2;
-    background: #936C36;
-    border-color: #AE8443;
-}
-
-.alert-danger {
-    color: #fff4f4;
-    background: #834040;
-    border-color: #8C2F2F
-}
-
-/* For tabbed content */
-
-.tabGroup {
-    margin-top: 1rem;
-}
-
-.tabGroup ul[role="tablist"] {
-    margin: 0;
-    padding: 0;
-    list-style: none;
-}
-
-.tabGroup ul[role="tablist"]>li {
-    list-style: none;
-    display: inline-block;
-}
-
-.tabGroup a[role="tab"] {
-    color: white;
-    box-sizing: border-box;
-    display: inline-block;
-    padding: 5px 7.5px;
-    text-decoration: none;
-    border-bottom: 2px solid #fff;
-}
-
-.tabGroup a[role="tab"]:hover,
-.tabGroup a[role="tab"]:focus,
-.tabGroup a[role="tab"][aria-selected="true"] {
-    border-bottom: 2px solid #607D8B;
-}
-
-.tabGroup a[role="tab"][aria-selected="true"] {
-    color: #81D4FA;
-}
-
-.tabGroup a[role="tab"]:hover,
-.tabGroup a[role="tab"]:focus {
-    color: #29B6F6;
-}
-
-.tabGroup a[role="tab"]:focus {
-    outline: 1px solid #607D8B;
-    outline-offset: -1px;
-}
-
-@media (min-width: 768px) {
-    .tabGroup a[role="tab"] {
-        padding: 5px 15px;
-    }
-}
-
-.tabGroup section[role="tabpanel"] {
-    border: 1px solid #607D8B;
-    padding: 15px;
-    margin: 0;
-    overflow: hidden;
-}
-
-.tabGroup section[role="tabpanel"]>.codeHeader,
-.tabGroup section[role="tabpanel"]>pre {
-    margin-left: -16px;
-    margin-right: -16px;
-}
-
-.tabGroup section[role="tabpanel"]> :first-child {
-    margin-top: 0;
-}
-
-.tabGroup section[role="tabpanel"]>pre:last-child {
-    display: block;
-    margin-bottom: -16px;
-}
-
-.mainContainer[dir='rtl'] main ul[role="tablist"] {
-    margin: 0;
-}
-
-/* code */
-
-code {
-    color: white;
-    background-color: #5B646B;
-    border-radius: 4px;
-    padding: 3px 7px;
-}
-
-pre {
-    background-color: #282a36;
-}
-
-/* table */
-
-.table-striped>tbody>tr:nth-of-type(odd) {
-    background-color: #333333;
-    color: #d3d3d3
-}
-
-tbody>tr {
-    background-color: #424242;
-    color: #c0c0c0
-}
-
-.table>tbody+tbody {
-    border-top: 2px solid rgb(173, 173, 173)
-}
-
-/* select */
-
-select {
-    background-color: #3b3b3b;
-    border-color: #2e2e2e;
-}
-
-/* 
-    Following code regarding collapse container are fetched 
-    or modified from the Materialize project.
-
-    The MIT License (MIT)
-    Copyright (c) 2014-2018 Materialize
-    https://github.com/Dogfalo/materialize
-*/
-
-/* all collapse container */
-.collapse-container.last-modified {
-    -webkit-box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
-    box-shadow: 0 2px 2px 0 rgba(50, 50, 50, 0.64), 0 3px 1px -2px rgba(50, 50, 50, 0.62), 0 1px 5px 0 rgba(50, 50, 50, 0.7);
-    border-top: 1px solid rgba(96, 96, 96, 0.7);
-    border-right: 1px solid rgba(96, 96, 96, 0.7);
-    border-left: 1px solid rgba(96, 96, 96, 0.7);
-}
-
-/* header */
-.collapse-container.last-modified>:nth-child(odd) {
-    background-color: #3f3f3f;
-    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
-}
-
-/* body */
-.collapse-container.last-modified>:nth-child(even) {
-    border-bottom: 1px solid rgba(96, 96, 96, 0.7);
-    background-color: inherit;
-}
-
-span.arrow-d{
-    border-top: 5px solid white
-}
-
-span.arrow-r{
-    border-left: 5px solid white
-}
-
-.logo-switcher {
-    background: url("/marketing/logo/SVG/Combinationmark White.svg") no-repeat;
-}

docs/_template/light-dark-theme/styles/light.css

@@ -1,117 +0,0 @@
-/* Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License. See License.txt in the project root for license information. */
-
-@import url('tomorrow.css');
-html,
-body {
-    background: #fff;
-    color: #000;
-}
-
-.sideaffix {
-    overflow: visible;
-}
-
-/* links */
-
-a:active, a:hover, a:visited {
-    color: #0078d7;
-}
-
-a {
-    color: #0050c5;
-    cursor: pointer;
-    text-decoration: none;
-    word-wrap: break-word;
-}
-
-/* alert */
-.alert-info {
-    color: #165e82;
-    background-color: #c1e0ef;
-    border-color: #8cbfd8;
-}
-
-.alert-warning {
-    color: #825e16;
-    background-color: #efe0c1;
-    border-color: #d8bf8c;
-}
-
-.alert-danger {
-    color: #821616;
-    background-color: #efc1c1;
-    border-color: #d88c8c;
-}
-
-/* code */
-
-code {
-    color: #9c3a3f;
-    background-color: #ececec;
-    border-radius: 4px;
-    padding: 3px 7px;
-}
-
-/* table */
-
-.table-striped>tbody>tr:nth-of-type(odd) {
-    color: #333333;
-    background-color: #d3d3d3
-}
-
-tbody>tr {
-    color: #424242;
-    background-color: #c0c0c0
-}
-
-.table>tbody+tbody {
-    border-top: 2px solid rgb(173, 173, 173)
-}
-
-/* select */
-
-select {
-    background-color: #fcfcfc;
-    border-color: #aeb1b5;
-}
-
-/* 
-    Following code regarding collapse container are fetched 
-    or modified from the Materialize project.
-
-    The MIT License (MIT)
-    Copyright (c) 2014-2018 Materialize
-    https://github.com/Dogfalo/materialize
-*/
-
-/* all collapse container */
-.collapse-container.last-modified {
-    -webkit-box-shadow: 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 3px 1px -2px rgba(0, 0, 0, 0.12), 0 1px 5px 0 rgba(0, 0, 0, 0.2);
-    box-shadow: 0 2px 2px 0 rgba(0, 0, 0, 0.14), 0 3px 1px -2px rgba(0, 0, 0, 0.12), 0 1px 5px 0 rgba(0, 0, 0, 0.2);
-    border-top: 1px solid #ddd;
-    border-right: 1px solid #ddd;
-    border-left: 1px solid #ddd;
-}
-
-/* header */
-.collapse-container.last-modified>:nth-child(odd) {
-    background-color: #fff;
-    border-bottom: 1px solid #ddd;
-}
-
-/* body */
-.collapse-container.last-modified>:nth-child(even) {
-    border-bottom: 1px solid #ddd;
-}
-
-span.arrow-d{
-    border-top: 5px solid black
-}
-
-span.arrow-r{
-    border-left: 5px solid black
-}
-
-.logo-switcher {
-    background: url("/marketing/logo/SVG/Combinationmark.svg") no-repeat;
-}

docs/_template/light-dark-theme/styles/master.css

@@ -1,175 +0,0 @@
-@import url('https://fonts.googleapis.com/css?family=Titillium+Web|Noto+Sans');
-
-html,
-body {
-    font-family: 'Titillium Web', 'Segoe UI', Tahoma, Helvetica, sans-serif;
-    font-display: optional;
-    height: 100%;
-    font-size: 15px;
-    scroll-behavior: smooth;
-}
-
-#logo
-{
-    max-width: 100px;
-    max-height: 100px;
-    width: 38pt;
-    height: 38pt;
-    padding: 8pt;
-}
-
-p,
-li,
-.toc {
-    text-rendering: optimizeLegibility;
-    line-height: 160%;
-}
-
-img {
-    box-shadow: 0px 0px 3px 0px rgb(66, 66, 66);
-    max-width: 95% !important;
-    margin-top: 15px;
-    margin-bottom: 15px;
-}
-
-.big-logo {
-    display: block;
-    box-shadow: none !important;
-    /* Width value was taken from the original size of the combomark svg */
-    width: 951pt;
-    /* Height was arbitrarily determined */
-    min-height: 100pt;
-    max-width: 90%;
-}
-
-article.content p{
-    -webkit-transition: all .75s ease-in-out;
-    transition: all .75s ease-in-out;
-}
-
-article.content h1,
-article.content h2,
-article.content h3,
-article.content h4,
-article.content h5,
-article.content h6{
-    -webkit-transition: all .25s ease-in-out;
-    transition: all .25s ease-in-out;
-}
-
-h1,
-h2,
-h3,
-h4,
-h5,
-h6 {
-    font-family: 'Noto Sans', Verdana, Geneva, Tahoma, sans-serif;
-    line-height: 130%;
-}
-
-.sideaffix {
-    line-height: 140%;
-}
-
-header .navbar {
-    border-width: 0 0 0px;
-    border-radius: 0;
-}
-
-body .toc {
-    background-color: inherit;
-    overflow: visible;
-}
-
-select {
-    display: inline-block;
-    overflow: auto;
-    -webkit-box-sizing: border-box;
-    box-sizing: border-box;
-    margin: 0;
-    padding: 0 30px 0 6px;
-    vertical-align: middle;
-    height: 28px;
-    border: 1px solid #e3e3e3;
-    line-height: 16px;
-    outline: 0;
-    text-overflow: ellipsis;
-    -webkit-appearance: none;
-    -moz-appearance: none;
-    cursor: pointer;
-    background-image: linear-gradient(45deg, transparent 50%, #707070 0), linear-gradient(135deg, #707070 50%, transparent 0);
-    background-position: calc(100% - 13px) 11px, calc(100% - 8px) 11px;
-    background-size: 5px 5px, 5px 6px;
-    background-repeat: no-repeat;
-}
-
-/* 
-    Following code are fetched or modified from 
-    the Materialize project.
-
-    The MIT License (MIT)
-    Copyright (c) 2014-2018 Materialize
-    https://github.com/Dogfalo/materialize
-*/
-
-/* all collapse container */
-
-.collapse-container.last-modified {
-    margin: 0.5rem 0 1rem 0;
-}
-
-/* header */
-
-.collapse-container.last-modified>:nth-child(odd):focus {
-    outline: 0;
-}
-
-.collapse-container.last-modified>:nth-child(odd) {
-    display: -webkit-box;
-    display: -webkit-flex;
-    display: -ms-flexbox;
-    display: flex;
-    cursor: pointer;
-    -webkit-tap-highlight-color: transparent;
-    line-height: 1.5;
-    padding: 0.75rem;
-    background-image: none;
-    border: 0px;
-}
-
-/* body */
-
-.collapse-container.last-modified>:nth-child(even) {
-    display: none;
-    -webkit-box-sizing: border-box;
-    box-sizing: border-box;
-    padding: 1rem;
-    border: 0px;
-}
-
-/* nav bar */
-
-.nav {
-    margin: 0;
-}
-
-.nav li {
-    -webkit-transition: background-color .3s, color .3s;
-    transition: background-color .3s, color .3s;
-}
-
-.nav a {
-    -webkit-transition: background-color .3s, color .3s;
-    transition: background-color .3s, color .3s;
-    cursor: pointer;
-}
-
-/* arrow */
-
-span.arrow-d{
-    top: 6px; position: relative;
-}
-
-span.arrow-r{
-    top: 6px; position: relative;
-}

docs/_template/light-dark-theme/styles/plugin-featherlight.js

@@ -1,37 +0,0 @@
-// MIT License
-
-// Copyright (c) 2017 Roel Fauconnier
-
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-
-// The above copyright notice and this permission notice shall be included in all
-// copies or substantial portions of the Software.
-
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-// SOFTWARE.
-
-$(document).ready(function() {
-        //find all images, but not the logo, and add the lightbox
-        $('img').not('#logo').each(function(){
-            var $img = $(this);
-            var filename = $img.attr('src')
-            //add cursor
-            $img.css('cursor','zoom-in');
-            $img.css('cursor','-moz-zoom-in');
-            $img.css('cursor','-webkit-zoom-in');
-
-            //add featherlight
-            $img.attr('alt', filename);
-            $img.featherlight(filename);
-    });
-});

docs/_template/light-dark-theme/styles/styleswitcher.js

@@ -1,26 +0,0 @@
-const baseUrl = document.getElementById("docfx-style:rel").content;
-
-function onThemeSelect(event) {
-    const theme = event.target.value;
-    window.localStorage.setItem("theme", theme);
-    window.themeElement.href = getUrl(theme);
-}
-
-function getUrl(slug) {
-    return baseUrl + "styles/" + slug + ".css";
-}
-
-const themeElement = document.createElement("link");
-themeElement.rel = "stylesheet";
-
-const theme = window.localStorage.getItem("theme") || "light";
-themeElement.href = getUrl(theme);
-
-document.head.appendChild(themeElement);
-window.themeElement = themeElement;
-
-document.addEventListener("DOMContentLoaded", function() {
-    const themeSwitcher = document.getElementById("theme-switcher");
-    themeSwitcher.onchange = onThemeSelect;
-    themeSwitcher.value = theme;
-}, false);

docs/_template/light-dark-theme/styles/theme-switcher.css

@@ -1,9 +0,0 @@
-div.theme-switch-field {
-    padding-left: 10px;
-    padding-bottom: 15px
-}
-
-div.theme-switch-field > p{
-    font-weight: bold;
-    font-size: 1.2em;
-}

docs/_template/light-dark-theme/styles/tomorrow.css

@@ -1,72 +0,0 @@
-/* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
-
-/* Tomorrow Comment */
-.hljs-comment,
-.hljs-quote {
-  color: #8e908c;
-}
-
-/* Tomorrow Red */
-.hljs-variable,
-.hljs-template-variable,
-.hljs-tag,
-.hljs-name,
-.hljs-selector-id,
-.hljs-selector-class,
-.hljs-regexp,
-.hljs-deletion {
-  color: #c82829;
-}
-
-/* Tomorrow Orange */
-.hljs-number,
-.hljs-built_in,
-.hljs-builtin-name,
-.hljs-literal,
-.hljs-type,
-.hljs-params,
-.hljs-meta,
-.hljs-link {
-  color: #f5871f;
-}
-
-/* Tomorrow Yellow */
-.hljs-attribute {
-  color: #eab700;
-}
-
-/* Tomorrow Green */
-.hljs-string,
-.hljs-symbol,
-.hljs-bullet,
-.hljs-addition {
-  color: #718c00;
-}
-
-/* Tomorrow Blue */
-.hljs-title,
-.hljs-section {
-  color: #4271ae;
-}
-
-/* Tomorrow Purple */
-.hljs-keyword,
-.hljs-selector-tag {
-  color: #8959a8;
-}
-
-.hljs {
-  display: block;
-  overflow-x: auto;
-  background: white;
-  color: #4d4d4c;
-  padding: 0.5em;
-}
-
-.hljs-emphasis {
-  font-style: italic;
-}
-
-.hljs-strong {
-  font-weight: bold;
-}

docs/_template/light-dark-theme/styles/vs2015.css

@@ -1,115 +0,0 @@
-/*
- * Visual Studio 2015 dark style
- * Author: Nicolas LLOBERA <nllobera@gmail.com>
- */
-
-.hljs {
-  display: block;
-  overflow-x: auto;
-  padding: 0.5em;
-  background: #282a36;
-  color: #DCDCDC;
-}
-
-.hljs-keyword,
-.hljs-literal,
-.hljs-symbol,
-.hljs-name {
-  color: #569CD6;
-}
-.hljs-link {
-  color: #569CD6;
-  text-decoration: underline;
-}
-
-.hljs-built_in,
-.hljs-type {
-  color: #4EC9B0;
-}
-
-.hljs-number,
-.hljs-class {
-  color: #B8D7A3;
-}
-
-.hljs-string,
-.hljs-meta-string {
-  color: #D69D85;
-}
-
-.hljs-regexp,
-.hljs-template-tag {
-  color: #9A5334;
-}
-
-.hljs-subst,
-.hljs-function,
-.hljs-title,
-.hljs-params,
-.hljs-formula {
-  color: #DCDCDC;
-}
-
-.hljs-comment,
-.hljs-quote {
-  color: #57A64A;
-  font-style: italic;
-}
-
-.hljs-doctag {
-  color: #608B4E;
-}
-
-.hljs-meta,
-.hljs-meta-keyword,
-.hljs-tag {
-  color: #9B9B9B;
-}
-
-.hljs-variable,
-.hljs-template-variable {
-  color: #BD63C5;
-}
-
-.hljs-attr,
-.hljs-attribute,
-.hljs-builtin-name {
-  color: #9CDCFE;
-}
-
-.hljs-section {
-  color: gold;
-}
-
-.hljs-emphasis {
-  font-style: italic;
-}
-
-.hljs-strong {
-  font-weight: bold;
-}
-
-/*.hljs-code {
-  font-family:'Monospace';
-}*/
-
-.hljs-bullet,
-.hljs-selector-tag,
-.hljs-selector-id,
-.hljs-selector-class,
-.hljs-selector-attr,
-.hljs-selector-pseudo {
-  color: #D7BA7D;
-}
-
-.hljs-addition {
-  background-color: #144212;
-  display: inline-block;
-  width: 100%;
-}
-
-.hljs-deletion {
-  background-color: #600;
-  display: inline-block;
-  width: 100%;
-}

docs/api/.gitignore

@@ -1,6 +0,0 @@
-
-###############
-#  temp file  #
-###############
-*.yml
-.manifest

docs/api/index.md

@@ -1,16 +0,0 @@
----
-uid: API.Docs
----
-
-# API Documentation
-
-This is where you will find documentation for all members and objects in Discord.Net.
-
-# Commonly Used Entities
-
-* @Discord.WebSocket
-* @Discord.WebSocket.DiscordSocketClient
-* @Discord.WebSocket.SocketGuildChannel
-* @Discord.WebSocket.SocketGuildUser
-* @Discord.WebSocket.SocketMessage
-* @Discord.WebSocket.SocketRole

docs/docfx.json

@@ -1,62 +0,0 @@
-{
-  "metadata": [{
-    "src": [{
-      "src": "../src",
-      "files": [
-        "**.csproj"
-      ]
-    }],
-    "dest": "api",
-    "filter": "filterConfig.yml",
-    "properties": {
-      "TargetFramework": "netstandard1.3"
-    }
-  }],
-  "build": {
-    "content": [{
-        "files": ["api/**.yml", "api/index.md"]
-      },
-      {
-        "files": ["toc.yml", "index.md"]
-      },
-      {
-        "files": ["faq/**.md", "faq/**/toc.yml"]
-      },
-      {
-        "files": ["guides/**.md", "guides/**/toc.yml"]
-      },
-      {
-        "src": "../",
-        "files": [ "CHANGELOG.md" ]
-      }
-    ],
-    "resource": [{
-      "files": [
-        "**/images/**",
-        "**/samples/**",
-        "langwordMapping.yml",
-        "marketing/logo/SVG/**.svg",
-        "favicon.ico"
-      ]
-    }],
-    "dest": "_site",
-    "template": [
-      "default",
-      "_template/light-dark-theme",
-      "_template/last-modified",
-      "_template/description-generator"
-    ],
-    "postProcessors": ["ExtractSearchIndex", "LastModifiedPostProcessor", "DescriptionPostProcessor"],
-    "overwrite": "_overwrites/**/**.md",
-    "globalMetadata": {
-      "_appTitle": "Discord.Net Documentation",
-      "_appFooter": "Discord.Net (c) 2015-2018 2.0.0-beta",
-      "_enableSearch": true,
-      "_appLogoPath": "marketing/logo/SVG/Logomark Purple.svg",
-      "_appFaviconPath":  "favicon.ico"
-    },
-    "xrefService": [
-      "https://xref.docs.microsoft.com/query?uid={uid}"
-    ]
-  }
-}

docs/faq/basics/basic-operations.md

@@ -1,123 +0,0 @@
----
-uid: FAQ.Basics.BasicOp
-title: Questions about Basic Operations
----
-
-# Basic Operations Questions
-
-In the following section, you will find commonly asked questions and
-answers regarding basic usage of the library, as well as
-language-specific tips when using this library.
-
-## How should I safely check a type?
-
-> [!WARNING]
-> Direct casting (e.g., `(Type)type`) is **the least recommended**
-> way of casting, as it *can* throw an [InvalidCastException]
-> when the object isn't the desired type.
->
-> Please refer to [this post] for more details.
-
-In Discord.Net, the idea of polymorphism is used throughout. You may
-need to cast the object as a certain type before you can perform any
-action.
-
-A good and safe casting example:
-
-[!code-csharp[Casting](samples/cast.cs)]
-
-[InvalidCastException]: https://docs.microsoft.com/en-us/dotnet/api/system.invalidcastexception
-[this post]: https://docs.microsoft.com/en-us/dotnet/csharp/how-to/safely-cast-using-pattern-matching-is-and-as-operators
-
-## How do I send a message?
-
-> [!TIP]
-> The [GetChannel] method by default returns an [IChannel], allowing
-> channel types such as [IVoiceChannel], [ICategoryChannel]
-> to be returned; consequently, you cannot send a message
-> to channels like those.
-
-Any implementation of [IMessageChannel] has a [SendMessageAsync]
-method. You can get the channel via [GetChannel] under the client.
-Remember, when using Discord.Net, polymorphism is a common recurring
-theme. This means an object may take in many shapes or form, which
-means casting is your friend. You should attempt to cast the channel
-as an [IMessageChannel] or any other entity that implements it to be
-able to message.
-
-[SendMessageAsync]: xref:Discord.IMessageChannel.SendMessageAsync*
-[GetChannel]: xref:Discord.WebSocket.DiscordSocketClient.GetChannel*
-
-## How can I tell if a message is from X, Y, Z channel?
-
-You may check the message channel type. Visit [Glossary] to see the
-various types of channels.
-
-[Glossary]: xref:FAQ.Glossary#message-channels
-
-## How can I get the guild from a message?
-
-There are 2 ways to do this. You can do either of the following,
-
-1. Cast the user as an [IGuildUser] and use its [IGuild] property.
-2. Cast the channel as an [IGuildChannel] and use its [IGuild] property.
-
-## How do I add hyperlink text to an embed?
-
-Embeds can use standard [markdown] in the description field as well
-as in field values. With that in mind, links can be added with
-`[text](link)`.
-
-[markdown]: https://support.discordapp.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-
-
-## How do I add reactions to a message?
-
-Any entity that implements [IUserMessage] has an [AddReactionAsync]
-method. This method expects an [IEmote] as a parameter.
-In Discord.Net, an Emote represents a custom-image emote, while an
-Emoji is a Unicode emoji (standard emoji). Both [Emoji] and [Emote]
-implement [IEmote] and are valid options.
-
-# [Adding a reaction to another message](#tab/emoji-others)
-
-[!code-csharp[Emoji](samples/emoji-others.cs)]
-
-# [Adding a reaction to a sent message](#tab/emoji-self)
-
-[!code-csharp[Emoji](samples/emoji-self.cs)]
-
-***
-
-[AddReactionAsync]: xref:Discord.IUserMessage.AddReactionAsync*
-
-## What is a "preemptive rate limit?"
-
-A preemptive rate limit is Discord.Net's way of telling you to slow
-down before you get hit by the real rate limit. Hitting a real rate
-limit might prevent your entire client from sending any requests for
-a period of time. This is calculated based on the HTTP header
-returned by a Discord response.
-
-## Why am I getting so many preemptive rate limits when I try to add more than one reactions?
-
-This is due to how HTML header works, mistreating
-0.25sec/action to 1sec. This causes the lib to throw preemptive rate
-limit more frequently than it should for methods such as adding
-reactions.
-
-## Can I opt-out of preemptive rate limits?
-
-Unfortunately, not at the moment. See [#401](https://github.com/RogueException/Discord.Net/issues/401).
-
-[IChannel]: xref:Discord.IChannel
-[ICategoryChannel]: xref:Discord.ICategoryChannel
-[IGuildChannel]: xref:Discord.IGuildChannel
-[ITextChannel]: xref:Discord.ITextChannel
-[IGuild]: xref:Discord.IGuild
-[IVoiceChannel]: xref:Discord.IVoiceChannel
-[IGuildUser]: xref:Discord.IGuildUser
-[IMessageChannel]: xref:Discord.IMessageChannel
-[IUserMessage]: xref:Discord.IUserMessage
-[IEmote]: xref:Discord.IEmote
-[Emote]: xref:Discord.Emote
-[Emoji]: xref:Discord.Emoji

docs/faq/basics/client-basics.md

@@ -1,94 +0,0 @@
----
-uid: FAQ.Basics.ClientBasics
-title: Basic Questions about Client
----
-
-# Client Basics Questions
-
-In the following section, you will find commonly asked questions and
-answers about common issues that you may face when utilizing the
-various clients offered by the library.
-
-## My client keeps returning 401 upon logging in!
-
-> [!WARNING]
-> Userbot/selfbot (logging in with a user token) is no
-> longer supported with this library starting from 2.0, as
-> logging in under a user account may result in account termination.
->
-> For more information, see issue [827] & [958], as well as the official
-> [Discord API Terms of Service].
-
-There are few possible reasons why this may occur.
-
-1. You are not using the appropriate [TokenType]. If you are using a
- bot account created from the Discord Developer portal, you should
- be using `TokenType.Bot`.
-2. You are not using the correct login credentials. Please keep in
- mind that a token is **different** from a *client secret*.
-
-[TokenType]: xref:Discord.TokenType
-[827]: https://github.com/RogueException/Discord.Net/issues/827
-[958]: https://github.com/RogueException/Discord.Net/issues/958
-[Discord API Terms of Service]: https://discordapp.com/developers/docs/legal
-
-## How do I do X, Y, Z when my bot connects/logs on? Why do I get a `NullReferenceException` upon calling any client methods after connect?
-
-Your bot should **not** attempt to interact in any way with
-guilds/servers until the [Ready] event fires. When the bot
-connects, it first has to download guild information from
-Discord for you to get access to any server
-information; the client is not ready at this point.
-
-Technically, the [GuildAvailable] event fires once the data for a
-particular guild has downloaded; however, it is best to wait for all
-guilds to be downloaded. Once all downloads are complete, the [Ready]
-event is triggered, then you can proceed to do whatever you like.
-
-[Ready]: xref:Discord.WebSocket.DiscordSocketClient.Ready
-[GuildAvailable]: xref:Discord.WebSocket.BaseSocketClient.GuildAvailable
-
-## How do I get a message's previous content when that message is edited?
-
-If you need to do anything with messages (e.g., checking Reactions,
-checking the content of edited/deleted messages), you must set the
-[MessageCacheSize] in your [DiscordSocketConfig] settings in order to
-use the cached message entity. Read more about it [here](xref:Guides.Concepts.Events#cacheable).
-
-1. Message Cache must be enabled.
-2. Hook the MessageUpdated event. This event provides a *before* and
- *after* object.
-3. Only messages received *after* the bot comes online will be
- available in the cache.
-
-[MessageCacheSize]: xref:Discord.WebSocket.DiscordSocketConfig.MessageCacheSize
-[DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig
-[MessageUpdated]: xref:Discord.WebSocket.BaseSocketClient.MessageUpdated
-
-## What is a shard/sharded client, and how is it different from the `DiscordSocketClient`?
-As your bot grows in popularity, it is recommended that you should section your bot off into separate processes.
-The [DiscordShardedClient] is essentially a class that allows you to easily create and manage multiple [DiscordSocketClient]
-instances, with each one serving a different amount of guilds.
-
-There are very few differences from the [DiscordSocketClient] class, and it is very straightforward
-to modify your existing code to use a [DiscordShardedClient] when necessary.
-
-1. You need to specify the total amount of shards, or shard ids, via [DiscordShardedClient]'s constructors.
-2. The [Connected], [Disconnected], [Ready], and [LatencyUpdated] events
- are replaced with [ShardConnected], [ShardDisconnected], [ShardReady], and [ShardLatencyUpdated].
-3. Every event handler you apply/remove to the [DiscordShardedClient] is applied/removed to each shard.
- If you wish to control a specific shard's events, you can access an individual shard through the `Shards` property.
-
-If you do not wish to use the [DiscordShardedClient] and instead reuse the same [DiscordSocketClient] code and manually shard them,
-you can do so by specifying the [ShardId] for the [DiscordSocketConfig] and pass that to the [DiscordSocketClient]'s constructor.
-
-[DiscordSocketClient]: xref:Discord.WebSocket.DiscordSocketClient
-[DiscordShardedClient]: xref:Discord.WebSocket.DiscordShardedClient
-[Connected]: xref:Discord.WebSocket.DiscordSocketClient.Connected
-[Disconnected]: xref:Discord.WebSocket.DiscordSocketClient.Disconnected
-[LatencyUpdated]: xref:Discord.WebSocket.DiscordSocketClient.LatencyUpdated
-[ShardConnected]: xref:Discord.WebSocket.DiscordShardedClient.ShardConnected
-[ShardDisconnected]: xref:Discord.WebSocket.DiscordShardedClient.ShardDisconnected
-[ShardReady]: xref:Discord.WebSocket.DiscordShardedClient.ShardReady
-[ShardLatencyUpdated]: xref:Discord.WebSocket.DiscordShardedClient.ShardLatencyUpdated
-[ShardId]: xref:Discord.WebSocket.DiscordSocketConfig.ShardId

docs/faq/basics/getting-started.md

@@ -1,79 +0,0 @@
----
-uid: FAQ.Basics.GetStarted
-title: Beginner Questions / How to Get Started
----
-
-# Basic Concepts / Getting Started
-
-In this following section, you will find commonly asked questions and
-answers about how to get started with Discord.Net, as well as basic
-introduction to the Discord API ecosystem.
-
-## How do I add my bot to my server/guild?
-
-You can do so by using the [permission calculator] provided
-by [FiniteReality].
-This tool allows you to set permissions that the bot will be assigned
-with, and invite the bot into your guild. With this method, bots will
-also be assigned a unique role that a regular user cannot use; this
-is what we call a `Managed` role. Because you cannot assign this
-role to any other users, it is much safer than creating a single
-role which, intentionally or not, can be applied to other users
-to escalate their privilege.
-
-[FiniteReality]: https://github.com/FiniteReality/permissions-calculator
-[permission calculator]: https://finitereality.github.io/permissions-calculator
-
-## What is a token?
-
-A token is a credential used to log into an account. This information
-should be kept **private** and for your eyes only. Anyone with your
-token can log into your account. This risk applies to both user
-and bot accounts. That also means that you should **never** hardcode
-your token or add it into source control, as your identity may be
-stolen by scrape bots on the internet that scours through 
-constantly to obtain a token.
-
-## What is a client/user/object ID?
-
-Each user and object on Discord has its own snowflake ID generated
-based on various conditions.
-
-![Snowflake Generation](images/snowflake.png)
-
-Anyone can see the ID; it is public. It is merely used to
-identify an object in the Discord ecosystem. Many things in the
-Discord ecosystem require an ID to retrieve or identify the said
-object.
-
-There are 2 common ways to obtain the said ID.
-
-### [Discord Developer Mode](#tab/dev-mode)
-
-By enabling the developer mode you can right click on most objects
-to obtain their snowflake IDs (please note that this may not apply to
-all objects, such as role IDs, or DM channel IDs).
-
-![Developer Mode](images/dev-mode.png)
-
-### [Escape Character](#tab/escape-char)
-
-You can escape an object by using `\` in front the object in the 
-Discord client. For example, when you do `\@Example#1234` in chat,
-it will return the user ID of the aforementioned user.
-
-![Escaping mentions](images/mention-escape.png)
-
-***
-
-## How do I get the role ID?
-
-> [!WARNING]
-> Right-clicking on the role and copying the ID will **not** work.
-> This will only copy the message ID.
-
-Several common ways to do this:
-
-1. Make the role mentionable and mention the role, and escape it
-  using the `\` character in front.
-2. Inspect the roles collection within the guild via your debugger.

docs/faq/basics/samples/cast.cs

@@ -1,15 +0,0 @@
-public async Task MessageReceivedHandler(SocketMessage msg)
-{
-   // Option 1:
-   // Using the `as` keyword, which will return `null` if the object isn't the desired type.
-   var usermsg = msg as SocketUserMessage;
-   // We bail when the message isn't the desired type.
-   if (msg == null) return;
-   
-   // Option 2:
-   // Using the `is` keyword to cast (C#7 or above only)
-   if (msg is SocketUserMessage usermsg) 
-   {
-      // Do things
-   }
-}

docs/faq/basics/samples/emoji-others.cs

@@ -1,18 +0,0 @@
-// bail if the message is not a user one (system messages cannot have reactions)
-var usermsg = msg as IUserMessage;
-if (usermsg == null) return;
-
-// standard Unicode emojis
-Emoji emoji = new Emoji("👍");
-// or
-// Emoji emoji = new Emoji("\uD83D\uDC4D");
-
-// custom guild emotes
-Emote emote = Emote.Parse("<:dotnet:232902710280716288>");  
-// using Emote.TryParse may be safer in regards to errors being thrown;
-// please note that the method does not verify if the emote exists,
-// it simply creates the Emote object for you.
-
-// add the reaction to the message
-await usermsg.AddReactionAsync(emoji); 
-await usermsg.AddReactionAsync(emote); 

docs/faq/basics/samples/emoji-self.cs

@@ -1,17 +0,0 @@
-// capture the message you're sending in a variable
-var msg = await channel.SendMessageAsync("This will have reactions added.");
-
-// standard Unicode emojis
-Emoji emoji = new Emoji("👍");
-// or
-// Emoji emoji = new Emoji("\uD83D\uDC4D");
-
-// custom guild emotes
-Emote emote = Emote.Parse("<:dotnet:232902710280716288>");  
-// using Emote.TryParse may be safer in regards to errors being thrown;
-// please note that the method does not verify if the emote exists,
-// it simply creates the Emote object for you.
-
-// add the reaction to the message
-await msg.AddReactionAsync(emoji); 
-await msg.AddReactionAsync(emote); 

docs/faq/commands/dependency-injection.md

@@ -1,54 +0,0 @@
----
-uid: FAQ.Commands.DI
-title: Questions about Dependency Injection with Commands
----
-
-# Dependency-injection-related Questions
-
-In the following section, you will find common questions and answers
-to utilizing dependency injection with @Discord.Commands, as well as
-common troubleshooting steps regarding DI.
-
-## What is a service? Why does my module not hold any data after execution?
-
-In Discord.Net, modules are created similarly to ASP.NET, meaning
-that they have a transient nature; modules are spawned whenever a
-request is received, and are killed from memory when the execution
-finishes. In other words, you cannot store persistent
-data inside a module. Consider using a service if you wish to
-workaround this.
-
-Service is often used to hold data externally so that they persist
-throughout execution. Think of it like a chest that holds
-whatever you throw at it that won't be affected by anything unless
-you want it to. Note that you should also learn Microsoft's
-implementation of [Dependency Injection] \([video]) before proceeding,
-as well as how it works in [Discord.Net](xref:Guides.Commands.DI#usage-in-modules).
-
-A brief example of service and dependency injection can be seen below.
-
-[!code-csharp[DI](samples/DI.cs)]
-
-[Dependency Injection]: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection
-[video]: https://www.youtube.com/watch?v=QtDTfn8YxXg
-
-## Why is my `CommandService` complaining about a missing dependency?
-
-If you encounter an error similar to `Failed to create MyModule,
-dependency MyExternalDependency was not found.`, you may have
-forgotten to add the external dependency to the dependency container.
-
-Starting from Discord.Net 2.0, all dependencies required by each
-module must be present when the module is loaded into the
-[CommandService]. This means when loading the module, you must pass a
-valid [IServiceProvider] with the dependency loaded before the module
-can be successfully registered.
-
-For example, if your module, `MyModule`, requests a `DatabaseService`
-in its constructor, the `DatabaseService` must be present in the
-[IServiceProvider] when registering `MyModule`.
-
-[!code-csharp[Missing Dependencies](samples/missing-dep.cs)]
-
-[IServiceProvider]: xref:System.IServiceProvider
-[CommandService]: xref:Discord.Commands.CommandService

docs/faq/commands/general.md

@@ -1,147 +0,0 @@
----
-uid: FAQ.Commands.General
-title: General Questions about Commands
----
-
-# Command-related Questions
-
-In the following section, you will find commonly asked questions and
-answered regarding general command usage when using @Discord.Commands.
-
-## How can I restrict some of my commands so only specific users can execute them?
-
-Based on how you want to implement the restrictions, you can use the
-built-in [RequireUserPermission] precondition, which allows you to
-restrict the command based on the user's current permissions in the
-guild or channel (*e.g., `GuildPermission.Administrator`,
-`ChannelPermission.ManageMessages`*).
-
-If, however, you wish to restrict the commands based on the user's
-role, you can either create your custom precondition or use
-Joe4evr's [Preconditions Addons] that provides a few custom
-preconditions that aren't provided in the stock library.
-Its source can also be used as an example for creating your
-custom preconditions.
-
-[RequireUserPermission]: xref:Discord.Commands.RequireUserPermissionAttribute
-[Preconditions Addons]: https://github.com/Joe4evr/Discord.Addons/tree/master/src/Discord.Addons.Preconditions
-
-## Why am I getting an error about `Assembly.GetEntryAssembly`?
-
-You may be confusing @Discord.Commands.CommandService.AddModulesAsync*
-with @Discord.Commands.CommandService.AddModuleAsync*. The former
-is used to add modules via the assembly, while the latter is used to
-add a single module.
-
-## What does [Remainder] do in the command signature?
-
-The [RemainderAttribute] leaves the string unparsed, meaning you
-do not have to add quotes around the text for the text to be
-recognized as a single object. Please note that if your method has
-multiple parameters, the remainder attribute can only be applied to
-the last parameter.
-
-[!code-csharp[Remainder](samples/Remainder.cs)]
-
-[RemainderAttribute]: xref:Discord.Commands.RemainderAttribute
-
-## Discord.Net keeps saying that a `MessageReceived` handler is blocking the gateway, what should I do?
-
-By default, the library warns the user about any long-running event
-handler that persists for **more than 3 seconds**. Any event
-handlers that are run on the same thread as the gateway task, the task
-in charge of keeping the connection alive, may block the processing of
-heartbeat, and thus terminating the connection.
-
-In this case, the library detects that a `MessageReceived`
-event handler is blocking the gateway thread. This warning is
-typically associated with the command handler as it listens for that
-particular event. If the command handler is blocking the thread, then
-this **might** mean that you have a long-running command.
-
-> [!NOTE]
-> In rare cases, runtime errors can also cause blockage, usually
-> associated with Mono, which is not supported by this library.
-
-To prevent a long-running command from blocking the gateway
-thread, a flag called [RunMode] is explicitly designed to resolve
-this issue.
-
-There are 2 main `RunMode`s.
-
-1. `RunMode.Sync`
-2. `RunMode.Async`
-
-`Sync` is the default behavior and makes the command to be run on the
-same thread as the gateway one. `Async` will spin the task off to a
-different thread from the gateway one.
-
-> [!IMPORTANT]
-> While specifying `RunMode.Async` allows the command to be spun off
-> to a different thread, keep in mind that by doing so, there will be
-> **potentially unwanted consequences**. Before applying this flag,
-> please consider whether it is necessary to do so.
->
-> Further details regarding `RunMode.Async` can be found below.
-
-You can set the `RunMode` either by specifying it individually via
-the `CommandAttribute` or by setting the global default with
-the [DefaultRunMode] flag under `CommandServiceConfig`.
-
-# [CommandAttribute](#tab/cmdattrib)
-
-[!code-csharp[Command Attribute](samples/runmode-cmdattrib.cs)]
-
-# [CommandServiceConfig](#tab/cmdconfig)
-
-[!code-csharp[Command Service Config](samples/runmode-cmdconfig.cs)]
-
-***
-
-***
-
-[RunMode]: xref:Discord.Commands.RunMode
-[CommandAttribute]: xref:Discord.Commands.CommandAttribute
-[DefaultRunMode]: xref:Discord.Commands.CommandServiceConfig.DefaultRunMode
-
-## How does `RunMode.Async` work, and why is Discord.Net *not* using it by default?
-
-`RunMode.Async` works by spawning a new `Task` with an unawaited
-[Task.Run], essentially making the task that is used to invoke the
-command task to be finished on a different thread. This design means
-that [ExecuteAsync] will be forced to return a successful
-[ExecuteResult] regardless of the actual execution result.
-
-The following are the known caveats with `RunMode.Async`,
-
-1. You can potentially introduce a race condition.
-2. Unnecessary overhead caused by the [async state machine].
-3. [ExecuteAsync] will immediately return [ExecuteResult] instead of
- other result types (this is particularly important for those who wish
- to utilize [RuntimeResult] in 2.0).
-4. Exceptions are swallowed in the `ExecuteAsync` result.
-
-However, there are ways to remedy some of these.
-
-For #3, in Discord.Net 2.0, the library introduces a new event called
-[CommandService.CommandExecuted], which is raised whenever the command is executed. 
-This event will be raised regardless of
-the `RunMode` type and will return the appropriate execution result
-and the associated @Discord.Commands.CommandInfo if applicable.
-
-For #4, exceptions are caught in [CommandService.Log] event under
-[LogMessage.Exception] as [CommandException] and in the 
-[CommandService.CommandExecuted] event under the [IResult] as 
-[ExecuteResult.Exception].
-
-[Task.Run]: https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task.run
-[async state machine]: https://www.red-gate.com/simple-talk/dotnet/net-tools/c-async-what-is-it-and-how-does-it-work/
-[ExecuteAsync]: xref:Discord.Commands.CommandService.ExecuteAsync*
-[ExecuteResult]: xref:Discord.Commands.ExecuteResult
-[RuntimeResult]: xref:Discord.Commands.RuntimeResult
-[CommandService.CommandExecuted]: xref:Discord.Commands.CommandService.CommandExecuted
-[CommandService.Log]: xref:Discord.Commands.CommandService.Log
-[LogMessage.Exception]: xref:Discord.LogMessage.Exception*
-[ExecuteResult.Exception]: xref:Discord.Commands.ExecuteResult.Exception*
-[CommandException]: xref:Discord.Commands.CommandException
-[IResult]: xref:Discord.Commands.IResult

docs/faq/commands/samples/DI.cs

@@ -1,28 +0,0 @@
-public class MyService
-{
-	public string MyCoolString { get; set; }
-}
-public class Setup
-{
-	public IServiceProvider BuildProvider() => 
-			new ServiceCollection()
-			.AddSingleton<MyService>()
-			.BuildServiceProvider();
-}
-public class MyModule : ModuleBase<SocketCommandContext>
-{
-	// Inject via public settable prop
-	public MyService MyService { get; set; }
-	
-	// ...or via the module's constructor
-
-	// private readonly MyService _myService;
-	// public MyModule (MyService myService) => _myService = myService;
-	
-	[Command("string")]
-	public Task GetOrSetStringAsync(string input)
-	{
-		if (string.IsNullOrEmpty(_myService.MyCoolString)) _myService.MyCoolString = input;
-		return ReplyAsync(_myService.MyCoolString);
-	}
-}

docs/faq/commands/samples/Remainder.cs

@@ -1,20 +0,0 @@
-//	Input: 
-//		!echo Coffee Cake
-
-//	Output:
-//		Coffee Cake
-[Command("echo")]
-public Task EchoRemainderAsync([Remainder]string text) => ReplyAsync(text);  
-
-//	Output:
-//		CommandError.BadArgCount
-[Command("echo-hassle")]
-public Task EchoAsync(string text) => ReplyAsync(text);
-
-//	The message would be seen as having multiple parameters, 
-//	while the method only accepts one. 
-//	Wrapping the message in quotes solves this.
-//	This way, the system knows the entire message is to be parsed as a 
-//	single String.
-//	e.g., 
-//		!echo "Coffee Cake"

docs/faq/commands/samples/missing-dep.cs

@@ -1,29 +0,0 @@
-public class MyModule : ModuleBase<SocketCommandContext>
-{
-    private readonly DatabaseService _dbService;
-    public MyModule(DatabaseService dbService)
-        => _dbService = dbService;
-}
-public class CommandHandler
-{
-    private readonly CommandService _commands;
-    private readonly IServiceProvider _services;
-    public CommandHandler(DiscordSocketClient client)
-    {
-        _services = new ServiceCollection()
-            .AddService<CommandService>()
-            .AddService(client)
-            // We are missing DatabaseService!
-            .BuildServiceProvider();
-    }
-    public async Task RegisterCommandsAsync()
-    {
-        // ...
-        // The method fails here because DatabaseService is a required
-        // dependency and cannot be resolved by the dependency
-        // injection service at runtime since the service is not
-        // registered in this instance of _services.
-        await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
-        // ...
-    }
-}

docs/faq/commands/samples/runmode-cmdattrib.cs

@@ -1,7 +0,0 @@
-[Command("process", RunMode = RunMode.Async)]
-public async Task ProcessAsync(string input)
-{
-	// Does heavy calculation here.
-	await Task.Delay(TimeSpan.FromMinute(1));
-	await ReplyAsync(input);
-}

docs/faq/commands/samples/runmode-cmdconfig.cs

@@ -1,10 +0,0 @@
-public class Setup
-{
-	private readonly CommandService _command;
-	
-	public Setup()
-	{
-		var config = new CommandServiceConfig{ DefaultRunMode = RunMode.Async };
-		_command = new CommandService(config);
-	}
-}

docs/faq/misc/glossary.md

@@ -1,82 +0,0 @@
----
-uid: FAQ.Glossary
-title: Common Terminologies / Glossary
----
-
-# Glossary
-
-This is an additional chapter for quick references to various common
-types that you may see within Discord.Net. To see more information
-regarding each type of object, click on the object to navigate
-to our API documentation page where you might find more explanation
-about it.
-
-## Common Types
-
-* A **Guild** ([IGuild]) is an isolated collection of users and
-channels, and are often referred to as "servers".
-	- Example: [Discord API](https://discord.gg/jkrBmQR)
-* A **Channel** ([IChannel]) represents a generic channel.
-	- Example: #dotnet_discord-net
-	- See [Channel Types](#channel-types)
-	
-[IGuild]: xref:Discord.IGuild
-[IChannel]: xref:Discord.IChannel
-
-## Channel Types
-
-### Message Channels
-* A **Text Channel** ([ITextChannel]) is a message channel from a
-Guild.
-* A **DM Channel** ([IDMChannel]) is a message channel from a DM.
-* A **Group Channel** ([IGroupChannel]) is a message channel from a
-Group.
-	- This is rarely used due to the bot's inability to join groups.
-* A **Private Channel** ([IPrivateChannel]) is a DM or a Group.
-* A **Message Channel** ([IMessageChannel]) can be any of the above.
-
-### Misc Channels
-* A **Guild Channel** ([IGuildChannel]) is a guild channel in a guild.
-	- This can be any channels that may exist in a guild.
-* A **Voice Channel** ([IVoiceChannel]) is a voice channel in a guild.
-* A **Category Channel** ([ICategoryChannel]) (2.0+) is a category that
-holds one or more sub-channels.
-* A **Nested Channel** ([INestedChannel]) (2.0+) is a channel that can
-exist under a category.
-
-[INestedChannel]: xref:Discord.INestedChannel
-[IGuildChannel]: xref:Discord.IGuildChannel
-[IMessageChannel]: xref:Discord.IMessageChannel
-[ITextChannel]: xref:Discord.ITextChannel
-[IGroupChannel]: xref:Discord.IGroupChannel
-[IDMChannel]: xref:Discord.IDMChannel
-[IPrivateChannel]: xref:Discord.IPrivateChannel
-[IVoiceChannel]: xref:Discord.IVoiceChannel
-[ICategoryChannel]: xref:Discord.ICategoryChannel
-
-## Emoji Types
-
-* An **Emote** ([Emote]) is a custom emote from a guild.
-	- Example: `<:dotnet:232902710280716288>`
-* An **Emoji** ([Emoji]) is a Unicode emoji.
-	- Example: `👍`
-
-[Emote]: xref:Discord.Emote
-[Emoji]: xref:Discord.Emoji
-
-## Activity Types
-
-* A **Game** ([Game]) refers to a user's game activity.
-* A **Rich Presence** ([RichGame]) refers to a user's detailed
-gameplay status.
-	- Visit [Rich Presence Intro] on Discord docs for more info.
-* A **Streaming Status** ([StreamingGame]) refers to user's activity
-for streaming on services such as Twitch.
-* A **Spotify Status** ([SpotifyGame]) (2.0+) refers to a user's
-activity for listening to a song on Spotify.
-
-[Game]: xref:Discord.Game
-[RichGame]: xref:Discord.RichGame
-[StreamingGame]: xref:Discord.StreamingGame
-[SpotifyGame]: xref:Discord.SpotifyGame
-[Rich Presence Intro]: https://discordapp.com/developers/docs/rich-presence/best-practices

docs/faq/misc/legacy.md

@@ -1,29 +0,0 @@
----
-uid: FAQ.Legacy
-title: Questions about Legacy Versions
----
-
-# Legacy Questions
-
-This section refers to legacy library-related questions that do not
-apply to the latest or recent version of the Discord.Net library.
-
-## X, Y, Z does not work! It doesn't return a valid value anymore.
-
-If you are currently using an older version of the stable branch,
-please upgrade to the latest pre-release version to ensure maximum
-compatibility. Several features may be broken in older
-versions and will likely not be fixed in the version branch due to
-their breaking nature.
-
-Visit the repo's [release tag] to see the latest public pre-release.
-
-[release tag]: https://github.com/RogueException/Discord.Net/releases
-
-## I came from an earlier version of Discord.Net 1.0, and DependencyMap doesn't seem to exist anymore in the later revision? What happened to it?
-
-The `DependencyMap` has been replaced with Microsoft's
-[DependencyInjection] Abstractions. An example usage can be seen
-[here](https://github.com/foxbot/DiscordBotBase/blob/csharp/src/DiscordBot/Program.cs#L36).
-
-[DependencyInjection]: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection

docs/faq/toc.yml

@@ -1,18 +0,0 @@
-- name: Basic Concepts
-  items:
-    - name: Getting Started
-      topicUid: FAQ.Basics.GetStarted
-    - name: Basic Operations
-      topicUid: FAQ.Basics.BasicOp
-    - name: Client Basics
-      topicUid: FAQ.Basics.ClientBasics
-- name: Commands
-  items: 
-    - name: General
-      topicUid: FAQ.Commands.General
-    - name: Dependency Injection
-      topicUid: FAQ.Commands.DI
-- name: Glossary
-  topicUid: FAQ.Glossary
-- name: Legacy or Upgrade
-  topicUid: FAQ.Legacy

docs/filterConfig.yml

@@ -1,7 +0,0 @@
-apiRules:
-- exclude:
-    uidRegex: ^Discord\.Net\..*$
-    type: Namespace
-- exclude:
-    uidRegex: ^Discord\.Analyzers$
-    type: Namespace

docs/guides/commands/dependency-injection.md

@@ -1,47 +0,0 @@
----
-uid: Guides.Commands.DI
-title: Dependency Injection
----
-
-# Dependency Injection
-
-The Command Service is bundled with a very barebone Dependency
-Injection service for your convenience. It is recommended that you use
-DI when writing your modules.
-
-## Setup
-
-1. Create a @Microsoft.Extensions.DependencyInjection.ServiceCollection.
-2. Add the dependencies to the service collection that you wish
- to use in the modules.
-3. Build the service collection into a service provider.
-4. Pass the service collection into @Discord.Commands.CommandService.AddModulesAsync* / @Discord.Commands.CommandService.AddModuleAsync* , @Discord.Commands.CommandService.ExecuteAsync* .
-
-### Example - Setting up Injection
-
-[!code-csharp[IServiceProvider Setup](samples/dependency-injection/dependency_map_setup.cs)]
-
-## Usage in Modules
-
-In the constructor of your module, any parameters will be filled in by
-the @System.IServiceProvider that you've passed.
-
-Any publicly settable properties will also be filled in the same
-manner.
-
-> [!NOTE]
-> Annotating a property with a [DontInjectAttribute] attribute will
-> prevent the property from being injected.
-
-> [!NOTE]
-> If you accept `CommandService` or `IServiceProvider` as a parameter
-> in your constructor or as an injectable property, these entries will
-> be filled by the `CommandService` that the module is loaded from and
-> the `IServiceProvider` that is passed into it respectively.
-
-### Example - Injection in Modules
-
-[!code-csharp[Injection Modules](samples/dependency-injection/dependency_module.cs)]
-[!code-csharp[Disallow Dependency Injection](samples/dependency-injection/dependency_module_noinject.cs)]
-
-[DontInjectAttribute]: xref:Discord.Commands.DontInjectAttribute

docs/guides/commands/intro.md

@@ -1,221 +0,0 @@
----
-uid: Guides.Commands.Intro
-title: Introduction to Command Service
----
-
-# The Command Service
-
-[Discord.Commands](xref:Discord.Commands) provides an attribute-based
-command parser.
-
-## Get Started
-
-To use commands, you must create a [Command Service] and a command
-handler.
-
-Included below is a barebone command handler. You can extend your
-command handler as much as you like; however, the below is the bare
-minimum.
-
-> [!NOTE]
-> The `CommandService` will optionally accept a [CommandServiceConfig],
-> which *does* set a few default values for you. It is recommended to
-> look over the properties in [CommandServiceConfig] and their default
-> values.
-
-[!code-csharp[Command Handler](samples/intro/command_handler.cs)]
-
-[Command Service]: xref:Discord.Commands.CommandService
-[CommandServiceConfig]: xref:Discord.Commands.CommandServiceConfig
-
-## With Attributes
-
-Starting from 1.0, commands can be defined ahead of time with
-attributes, or at runtime with builders.
-
-For most bots, ahead-of-time commands should be all you need, and this
-is the recommended method of defining commands.
-
-### Modules
-
-The first step to creating commands is to create a _module_.
-
-A module is an organizational pattern that allows you to write your
-commands in different classes and have them automatically loaded.
-
-Discord.Net's implementation of "modules" is influenced heavily by the
-ASP.NET Core's Controller pattern. This means that the lifetime of a
-module instance is only as long as the command is being invoked.
-
-Before we create a module, it is **crucial** for you to remember that
-in order to create a module and have it automatically discovered,
-your module must:
-
-* Be public
-* Inherit [ModuleBase]
-
-By now, your module should look like this:
-
-[!code-csharp[Empty Module](samples/intro/empty-module.cs)]
-
-> [!NOTE]
-> [ModuleBase] is an `abstract` class, meaning that you may extend it
-> or override it as you see fit. Your module may inherit from any
-> extension of ModuleBase.
-
-[IoC]: https://msdn.microsoft.com/en-us/library/ff921087.aspx
-[Dependency Injection]: https://msdn.microsoft.com/en-us/library/ff921152.aspx
-[ModuleBase]: xref:Discord.Commands.ModuleBase`1
-
-### Adding/Creating Commands
-
-> [!WARNING]
-> **Avoid using long-running code** in your modules wherever possible.
-> You should **not** be implementing very much logic into your
-> modules, instead, outsource to a service for that.
->
-> If you are unfamiliar with Inversion of Control, it is recommended
-> to read the MSDN article on [IoC] and [Dependency Injection].
-
-The next step to creating commands is actually creating the commands.
-
-For a command to be valid, it **must** have a return type of `Task`
-or `Task<RuntimeResult>`. Typically, you might want to mark this
-method as `async`, although it is not required.
-
-Then, flag your command with the [CommandAttribute]. Note that you must
-specify a name for this command, except for when it is part of a
-[Module Group](#module-groups).
-
-### Command Parameters
-
-Adding parameters to a command is done by adding parameters to the
-parent `Task`.
-
-For example:
-
-* To take an integer as an argument from the user, add `int num`.
-* To take a user as an argument from the user, add `IUser user`.
-* ...etc.
-
-Starting from 1.0, a command can accept nearly any type of argument;
-a full list of types that are parsed by default can
-be found in @Guides.Commands.TypeReaders.
-
-[CommandAttribute]: xref:Discord.Commands.CommandAttribute
-
-#### Optional Parameters
-
-Parameters, by default, are always required. To make a parameter
-optional, give it a default value (i.e., `int num = 0`).
-
-#### Parameters with Spaces
-
-To accept a comma-separated list, set the parameter to `params Type[]`.
-
-Should a parameter include spaces, the parameter **must** be
-wrapped in quotes. For example, for a command with a parameter
-`string food`, you would execute it with
-`!favoritefood "Key Lime Pie"`.
-
-If you would like a parameter to parse until the end of a command,
-flag the parameter with the [RemainderAttribute]. This will
-allow a user to invoke a command without wrapping a
-parameter in quotes.
-
-[RemainderAttribute]: xref:Discord.Commands.RemainderAttribute
-
-### Command Overloads
-
-You may add overloads to your commands, and the command parser will
-automatically pick up on it.
-
-If, for whatever reason, you have two commands which are ambiguous to
-each other, you may use the @Discord.Commands.PriorityAttribute to
-specify which should be tested before the other.
-
-The `Priority` attributes are sorted in ascending order; the higher
-priority will be called first.
-
-### Command Context
-
-Every command can access the execution context through the [Context]
-property on [ModuleBase]. `ICommandContext` allows you to access the
-message, channel, guild, user, and the underlying Discord client
-that the command was invoked from.
-
-Different types of `Context` may be specified using the generic variant
-of [ModuleBase]. When using a [SocketCommandContext], for example, the
-properties on this context will already be Socket entities, so you
-will not need to cast them.
-
-To reply to messages, you may also invoke [ReplyAsync], instead of
-accessing the channel through the [Context] and sending a message.
-
-> [!WARNING]
-> Contexts should **NOT** be mixed! You cannot have one module that
-> uses `CommandContext` and another that uses `SocketCommandContext`.
-
-[Context]: xref:Discord.Commands.ModuleBase`1.Context
-[SocketCommandContext]: xref:Discord.Commands.SocketCommandContext
-[ReplyAsync]: xref:Discord.Commands.ModuleBase`1.ReplyAsync*
-
-> [!TIP]
-> At this point, your module should look comparable to this example:
-> [!code-csharp[Example Module](samples/intro/module.cs)]
-
-#### Loading Modules Automatically
-
-The Command Service can automatically discover all classes in an
-`Assembly` that inherit [ModuleBase] and load them. Invoke
-[CommandService.AddModulesAsync] to discover modules and
-install them.
-
-To opt a module out of auto-loading, flag it with
-[DontAutoLoadAttribute].
-
-[DontAutoLoadAttribute]: xref:Discord.Commands.DontAutoLoadAttribute
-[CommandService.AddModulesAsync]: xref:Discord.Commands.CommandService.AddModulesAsync*
-
-#### Loading Modules Manually
-
-To manually load a module, invoke [CommandService.AddModuleAsync] by
-passing in the generic type of your module and optionally, a
-service provider.
-
-[CommandService.AddModuleAsync]: xref:Discord.Commands.CommandService.AddModuleAsync*
-
-### Module Constructors
-
-Modules are constructed using @Guides.Commands.DI. Any parameters
-that are placed in the Module's constructor must be injected into an
-@System.IServiceProvider first.
-
-> [!TIP]
-> Alternatively, you may accept an
-> `IServiceProvider` as an argument and extract services yourself,
-> although this is discouraged.
-
-### Module Properties
-
-Modules with `public` settable properties will have the dependencies
-injected after the construction of the module. See @Guides.Commands.DI
-to learn more.
-
-### Module Groups
-
-Module Groups allow you to create a module where commands are
-prefixed. To create a group, flag a module with the
-@Discord.Commands.GroupAttribute.
-
-Module Groups also allow you to create **nameless Commands**, where
-the [CommandAttribute] is configured with no name. In this case, the
-command will inherit the name of the group it belongs to.
-
-### Submodules
-
-Submodules are "modules" that reside within another one. Typically,
-submodules are used to create nested groups (although not required to
-create nested groups).
-
-[!code-csharp[Groups and Submodules](samples/intro/groups.cs)]

docs/guides/commands/post-execution.md

@@ -1,120 +0,0 @@
----
-uid: Guides.Commands.PostExecution
-title: Post-command Execution Handling
----
-
-# Post-execution Handling for Commands
-
-When developing commands, you may want to consider building a
-post-execution handling system so you can have finer control
-over commands. Discord.Net offers several post-execution workflows
-for you to work with.
-
-If you recall, in the [Command Guide], we have shown the following
-example for executing and handling commands,
-
-[!code[Command Handler](samples/intro/command_handler.cs)]
-
-You may notice that after we perform [ExecuteAsync], we store the
-result and print it to the chat, essentially creating the most
-fundamental form of a post-execution handler.
-
-With this in mind, we could start doing things like the following,
-
-[!code[Basic Command Handler](samples/post-execution/post-execution_basic.cs)]
-
-However, this may not always be preferred, because you are
-creating your post-execution logic *with* the essential command
-handler. This design could lead to messy code and could potentially
-be a violation of the SRP (Single Responsibility Principle).
-
-Another major issue is if your command is marked with
-`RunMode.Async`, [ExecuteAsync] will **always** return a successful
-[ExecuteResult] instead of the actual result. You can learn more
-about the impact in @FAQ.Commands.General.
-
-## CommandExecuted Event
-
-Enter [CommandExecuted], an event that was introduced in
-Discord.Net 2.0. This event is raised whenever a command is
-executed regardless of its execution status. This means this 
-event can be used to streamline your post-execution design,
-is not prone to `RunMode.Async`'s [ExecuteAsync] drawbacks.
-
-Thus, we can begin working on code such as:
-
-[!code[CommandExecuted demo](samples/post-execution/command_executed_demo.cs)]
-
-So now we have a streamlined post-execution pipeline, great! What's
-next? We can take this further by using [RuntimeResult].
-
-### RuntimeResult
-
-`RuntimeResult` was initially introduced in 1.0 to allow
-developers to centralize their command result logic.
-In other words, it is a result type that is designed to be
-returned when the command has finished its execution.
-
-However, it wasn't widely adopted due to the aforementioned
-[ExecuteAsync] drawback. Since we now have access to a proper
-result-handler via the [CommandExecuted] event, we can start
-making use of this class.
-
-The best way to make use of it is to create your version of
-`RuntimeResult`. You can achieve this by inheriting the `RuntimeResult`
-class.
-
-The following creates a bare-minimum required for a sub-class
-of `RuntimeResult`,
-
-[!code[Base Use](samples/post-execution/customresult_base.cs)]
-
-The sky is the limit from here. You can add any additional information
-you would like regarding the execution result.
-
-For example, you may want to add your result type or other
-helpful information regarding the execution, or something
-simple like static methods to help you create return types easily.
-
-[!code[Extended Use](samples/post-execution/customresult_extended.cs)]
-
-After you're done creating your [RuntimeResult], you can
-implement it in your command by marking the command return type to
-`Task<RuntimeResult>`.
-
-> [!NOTE]
-> You must mark the return type as `Task<RuntimeResult>` instead of
-> `Task<MyCustomResult>`. Only the former will be picked up when
-> building the module.
-
-Here's an example of a command that utilizes such logic:
-
-[!code[Usage](samples/post-execution/customresult_usage.cs)]
-
-And now we can check for it in our [CommandExecuted] handler:
-
-[!code[Usage](samples/post-execution/command_executed_adv_demo.cs)]
-
-## CommandService.Log Event
-
-We have so far covered the handling of various result types, but we
-have not talked about what to do if the command enters a catastrophic
-failure (i.e., exceptions). To resolve this, we can make use of the
-[CommandService.Log] event.
-
-All exceptions thrown during a command execution are caught and sent
-to the Log event under the [LogMessage.Exception] property
-as a [CommandException] type. The [CommandException] class allows
-us to access the exception thrown, as well as the context
-of the command.
-
-[!code[Logger Sample](samples/post-execution/command_exception_log.cs)]
-
-[CommandException]: xref:Discord.Commands.CommandException
-[LogMessage.Exception]: xref:Discord.LogMessage.Exception
-[CommandService.Log]: xref:Discord.Commands.CommandService.Log
-[RuntimeResult]: xref:Discord.Commands.RuntimeResult
-[CommandExecuted]: xref:Discord.Commands.CommandService.CommandExecuted
-[ExecuteAsync]: xref:Discord.Commands.CommandService.ExecuteAsync*
-[ExecuteResult]: xref:Discord.Commands.ExecuteResult
-[Command Guide]: xref:Guides.Commands.Intro

docs/guides/commands/preconditions.md

@@ -1,83 +0,0 @@
----
-uid: Guides.Commands.Preconditions
-title: Preconditions
----
-
-# Preconditions
-
-Preconditions serve as a permissions system for your Commands. Keep in
-mind, however, that they are not limited to _just_ permissions and can
-be as complex as you want them to be.
-
-There are two types of Preconditions you can use:
-
-* [PreconditionAttribute] can be applied to Modules, Groups, or Commands.
-* [ParameterPreconditionAttribute] can be applied to Parameters.
-
-You may visit their respective API documentation to find out more.
-
-[PreconditionAttribute]: xref:Discord.Commands.PreconditionAttribute
-[ParameterPreconditionAttribute]: xref:Discord.Commands.ParameterPreconditionAttribute
-
-## Bundled Preconditions
-
-@Discord.Commands ships with several bundled Preconditions for you
-to use.
-
-* @Discord.Commands.RequireContextAttribute
-* @Discord.Commands.RequireOwnerAttribute
-* @Discord.Commands.RequireBotPermissionAttribute
-* @Discord.Commands.RequireUserPermissionAttribute
-* @Discord.Commands.RequireNsfwAttribute
-
-## Using Preconditions
-
-To use a precondition, simply apply any valid precondition candidate to
-a command method signature as an attribute.
-
-### Example - Using a Precondition
-
-[!code-csharp[Precondition usage](samples/preconditions/precondition_usage.cs)]
-
-## ORing Preconditions
-
-When writing commands, you may want to allow some of them to be
-executed when only some of the precondition checks are passed.
-
-This is where the [Group] property of a precondition attribute comes in
-handy. By assigning two or more preconditions to a group, the command
-system will allow the command to be executed when one of the
-precondition passes.
-
-### Example - ORing Preconditions
-
-[!code-csharp[OR Precondition](samples/preconditions/group_precondition.cs)]
-
-[Group]: xref:Discord.Commands.PreconditionAttribute.Group
-
-## Custom Preconditions
-
-To write your own Precondition, create a new class that inherits from
-either [PreconditionAttribute] or [ParameterPreconditionAttribute]
-depending on your use.
-
-In order for your Precondition to function, you will need to override
-the [CheckPermissionsAsync] method.
-
-If the context meets the required parameters, return
-[PreconditionResult.FromSuccess], otherwise return
-[PreconditionResult.FromError] and include an error message if
-necessary.
-
-> [!NOTE]
-> Visual Studio can help you implement missing members
-> from the abstract class by using the "Implement Abstract Class"
-> IntelliSense hint.
-
-### Example - Creating a Custom Precondition
-
-[!code-csharp[Custom Precondition](samples/preconditions/require_role.cs)]
-
-[CheckPermissionsAsync]: xref:Discord.Commands.PreconditionAttribute.CheckPermissionsAsync*
-[PreconditionResult.FromSuccess]: xref:Discord.Commands.PreconditionResult.FromSuccess*
-[PreconditionResult.FromError]: xref:Discord.Commands.PreconditionResult.FromError*

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

@@ -1,62 +0,0 @@
-public class Initialize
-{
-	private readonly CommandService _commands;
-	private readonly DiscordSocketClient _client;
-
-	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/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(_database.GetData());
-    }
-}

docs/guides/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();
-    }
-}

docs/guides/commands/samples/intro/command_handler.cs

@@ -1,64 +0,0 @@
-public class CommandHandler
-{
-    private readonly DiscordSocketClient _client;
-    private readonly CommandService _commands;
-
-    public CommandHandler(DiscordSocketClient client, CommandService commands)
-    {
-        _commands = commands;
-        _client = client;
-    }
-    
-    public async Task InstallCommandsAsync()
-    {
-        // Hook the MessageReceived event into our command handler
-        _client.MessageReceived += HandleCommandAsync;
-
-        // Here we discover all of the command modules in the entry 
-        // assembly and load them. Starting from Discord.NET 2.0, a
-        // service provider is required to be passed into the
-        // module registration method to inject the 
-        // required dependencies.
-        //
-        // If you do not use Dependency Injection, pass null.
-        // See Dependency Injection guide for more information.
-        await _commands.AddModulesAsync(assembly: Assembly.GetEntryAssembly(), 
-                                        services: null);
-    }
-
-    private async Task HandleCommandAsync(SocketMessage messageParam)
-    {
-        // Don't process the command if it was a system message
-        var message = messageParam as SocketUserMessage;
-        if (message == null) return;
-
-        // Create a number to track where the prefix ends and the command begins
-        int argPos = 0;
-
-        // Determine if the message is a command based on the prefix and make sure no bots trigger commands
-        if (!(message.HasCharPrefix('!', ref argPos) || 
-            message.HasMentionPrefix(_client.CurrentUser, ref argPos)) ||
-            message.Author.IsBot)
-            return;
-
-        // Create a WebSocket-based command context based on the message
-        var context = new SocketCommandContext(_client, message);
-
-        // Execute the command with the command context we just
-        // created, along with the service provider for precondition checks.
-        
-        // Keep in mind that result does not indicate a return value
-        // rather an object stating if the command executed successfully.
-        var result = await _commands.ExecuteAsync(
-            context: context, 
-            argPos: argPos,
-            services: null);
-
-        // Optionally, we may inform the user if the command fails
-        // to be executed; however, this may not always be desired,
-        // as it may clog up the request queue should a user spam a
-        // command.
-        // if (!result.IsSuccess)
-        // await context.Channel.SendMessageAsync(result.ErrorReason);
-    }
-}

docs/guides/commands/samples/intro/empty-module.cs

@@ -1,8 +0,0 @@
-using Discord.Commands;
-
-// Keep in mind your module **must** be public and inherit ModuleBase.
-// If it isn't, it will not be discovered by AddModulesAsync!
-public class InfoModule : ModuleBase<SocketCommandContext>
-{
-    
-}

docs/guides/commands/samples/intro/groups.cs

@@ -1,25 +0,0 @@
-[Group("admin")]
-public class AdminModule : ModuleBase<SocketCommandContext>
-{
-    [Group("clean")]
-    public class CleanModule : ModuleBase<SocketCommandContext>
-    {
-        // ~admin clean
-        [Command]
-        public async Task DefaultCleanAsync()
-        {
-            // ...
-        }
-
-        // ~admin clean messages 15
-        [Command("messages")]
-        public async Task CleanAsync(int count)
-        {
-            // ...
-        }
-    }
-    // ~admin ban foxbot#0282
-    [Command("ban")]
-    public Task BanAsync(IGuildUser user) => 
-        Context.Guild.AddBanAsync(user);
-}

docs/guides/commands/samples/intro/module.cs

@@ -1,45 +0,0 @@
-// Create a module with no prefix
-public class InfoModule : ModuleBase<SocketCommandContext>
-{
-	// ~say hello world -> hello world
-	[Command("say")]
-	[Summary("Echoes a message.")]
-	public Task SayAsync([Remainder] [Summary("The text to echo")] string echo)
-		=> ReplyAsync(echo);
-		
-	// ReplyAsync is a method on ModuleBase 
-}
-
-// Create a module with the 'sample' prefix
-[Group("sample")]
-public class SampleModule : ModuleBase<SocketCommandContext>
-{
-	// ~sample square 20 -> 400
-	[Command("square")]
-	[Summary("Squares a number.")]
-	public async Task SquareAsync(
-		[Summary("The number to square.")] 
-		int num)
-	{
-		// We can also access the channel from the Command Context.
-		await Context.Channel.SendMessageAsync($"{num}^2 = {Math.Pow(num, 2)}");
-	}
-
-	// ~sample userinfo --> foxbot#0282
-	// ~sample userinfo @Khionu --> Khionu#8708
-	// ~sample userinfo Khionu#8708 --> Khionu#8708
-	// ~sample userinfo Khionu --> Khionu#8708
-	// ~sample userinfo 96642168176807936 --> Khionu#8708
-	// ~sample whois 96642168176807936 --> Khionu#8708
-	[Command("userinfo")]
-	[Summary
-	("Returns info about the current user, or the user parameter, if one passed.")]
-	[Alias("user", "whois")]
-	public async Task UserInfoAsync(
-		[Summary("The (optional) user to get info from")]
-		SocketUser user = null)
-	{
-		var userInfo = user ?? Context.Client.CurrentUser;
-		await ReplyAsync($"{userInfo.Username}#{userInfo.Discriminator}");
-	}
-}

docs/guides/commands/samples/post-execution/command_exception_log.cs

@@ -1,13 +0,0 @@
-public async Task LogAsync(LogMessage logMessage)
-{
-    // This casting type requries C#7
-    if (logMessage.Exception is CommandException cmdException)
-    {
-        // We can tell the user that something unexpected has happened
-        await cmdException.Context.Channel.SendMessageAsync("Something went catastrophically wrong!");
-
-        // We can also log this incident
-        Console.WriteLine($"{cmdException.Context.User} failed to execute '{cmdException.Command.Name}' in {cmdException.Context.Channel}.");
-        Console.WriteLine(cmdException.ToString());
-    }
-}

docs/guides/commands/samples/post-execution/command_executed_adv_demo.cs

@@ -1,13 +0,0 @@
-public async Task OnCommandExecutedAsync(Optional<CommandInfo> command, ICommandContext context, IResult result)
-{
-    switch(result)
-    {
-        case MyCustomResult customResult:
-            // do something extra with it
-            break;
-        default:
-            if (!string.IsNullOrEmpty(result.ErrorReason))
-                await context.Channel.SendMessageAsync(result.ErrorReason);
-            break;
-    }
-}

docs/guides/commands/samples/post-execution/command_executed_demo.cs

@@ -1,38 +0,0 @@
-public async Task SetupAsync()
-{
-    await _command.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
-    // Hook the execution event
-    _command.CommandExecuted += OnCommandExecutedAsync;
-    // Hook the command handler
-    _client.MessageReceived += HandleCommandAsync;
-}
-public async Task OnCommandExecutedAsync(Optional<CommandInfo> command, ICommandContext context, IResult result)
-{
-    // We have access to the information of the command executed,
-    // the context of the command, and the result returned from the
-    // execution in this event.
-
-    // We can tell the user what went wrong
-    if (!string.IsNullOrEmpty(result?.ErrorReason))
-    {
-        await context.Channel.SendMessageAsync(result.ErrorReason);
-    }
-
-    // ...or even log the result (the method used should fit into
-    // your existing log handler)
-    var commandName = command.IsSpecified ? command.Value.Name : "A command";
-    await _log.LogAsync(new LogMessage(LogSeverity.Info, 
-        "CommandExecution", 
-        $"{commandName} was executed at {DateTime.UtcNow}."));
-}
-public async Task HandleCommandAsync(SocketMessage msg)
-{
-    var message = messageParam as SocketUserMessage;
-    if (message == null) return;
-    int argPos = 0;
-    if (!(message.HasCharPrefix('!', ref argPos) || 
-        message.HasMentionPrefix(_client.CurrentUser, ref argPos)) || 
-        message.Author.IsBot) return;
-    var context = new SocketCommandContext(_client, message);
-    await _commands.ExecuteAsync(context, argPos, _services);
-}

docs/guides/commands/samples/post-execution/customresult_base.cs

@@ -1,6 +0,0 @@
-public class MyCustomResult : RuntimeResult
-{
-    public MyCustomResult(CommandError? error, string reason) : base(error, reason)
-    {
-    }
-}

docs/guides/commands/samples/post-execution/customresult_extended.cs

@@ -1,10 +0,0 @@
-public class MyCustomResult : RuntimeResult
-{
-    public MyCustomResult(CommandError? error, string reason) : base(error, reason)
-    {
-    }
-    public static MyCustomResult FromError(string reason) =>
-        new MyCustomResult(CommandError.Unsuccessful, reason);
-    public static MyCustomResult FromSuccess(string reason = null) =>
-        new MyCustomResult(null, reason);
-}

docs/guides/commands/samples/post-execution/customresult_usage.cs

@@ -1,10 +0,0 @@
-public class MyModule : ModuleBase<SocketCommandContext>
-{
-    [Command("eat")]
-    public async Task<RuntimeResult> ChooseAsync(string food)
-    {
-        if (food == "salad")
-            return MyCustomResult.FromError("No, I don't want that!");
-        return MyCustomResult.FromSuccess($"Give me the {food}!").
-    }
-}

docs/guides/commands/samples/post-execution/post-execution_basic.cs

@@ -1,14 +0,0 @@
-// Bad code!!!
-var result = await _commands.ExecuteAsync(context, argPos, _services);
-if (result.CommandError != null)
-	switch(result.CommandError)
-	{
-		case CommandError.BadArgCount:
-			await context.Channel.SendMessageAsync(
-				"Parameter count does not match any command's.");
-			break;
-		default:
-			await context.Channel.SendMessageAsync(
-				$"An error has occurred {result.ErrorReason}");
-			break;
-	}

docs/guides/commands/samples/preconditions/group_precondition.cs

@@ -1,9 +0,0 @@
-// The following example only requires the user to either have the
-// Administrator permission in this guild or own the bot application.
-[RequireUserPermission(GuildPermission.Administrator, Group = "Permission")]
-[RequireOwner(Group = "Permission")]
-public class AdminModule : ModuleBase<SocketCommandContext>
-{
-    [Command("ban")]
-    public Task BanAsync(IUser user) => Context.Guild.AddBanAsync(user);
-}

docs/guides/commands/samples/preconditions/precondition_usage.cs

@@ -1,3 +0,0 @@
-[RequireOwner]
-[Command("echo")]
-public Task EchoAsync(string input) => ReplyAsync(input);

docs/guides/commands/samples/preconditions/require_role.cs

@@ -1,32 +0,0 @@
-using System;
-using System.Threading.Tasks;
-using Discord.Commands;
-using Discord.WebSocket;
-
-// Inherit from PreconditionAttribute
-public class RequireRoleAttribute : PreconditionAttribute
-{
-    // Create a field to store the specified name
-    private readonly string _name;
-
-    // Create a constructor so the name can be specified
-    public RequireRoleAttribute(string name) => _name = name;
-
-    // Override the CheckPermissions method
-    public override Task<PreconditionResult> CheckPermissionsAsync(ICommandContext context, CommandInfo command, IServiceProvider services)
-    {
-        // Check if this user is a Guild User, which is the only context where roles exist
-        if (context.User is SocketGuildUser gUser)
-        {
-            // If this command was executed by a user with the appropriate role, return a success
-            if (gUser.Roles.Any(r => r.Name == _name))
-                // Since no async work is done, the result has to be wrapped with `Task.FromResult` to avoid compiler errors
-                return Task.FromResult(PreconditionResult.FromSuccess());
-            // Since it wasn't, fail
-            else
-                return Task.FromResult(PreconditionResult.FromError($"You must have a role named {_name} to run this command."));
-        }
-        else
-            return Task.FromResult(PreconditionResult.FromError("You must be in a guild to run this command."));
-    }
-}

docs/guides/commands/samples/typereaders/typereader-register.cs

@@ -1,29 +0,0 @@
-public class CommandHandler
-{
-    private readonly CommandService _commands;
-    private readonly DiscordSocketClient _client;
-    private readonly IServiceProvider _services;
-
-    public CommandHandler(CommandService commands, DiscordSocketClient client, IServiceProvider services)
-    {
-        _commands = commands;
-        _client = client;
-        _services = services;
-    }
-
-    public async Task SetupAsync()
-    {
-        _client.MessageReceived += CommandHandleAsync;
-
-        // Add BooleanTypeReader to type read for the type "bool"
-        _commands.AddTypeReader(typeof(bool), new BooleanTypeReader());
-
-        // Then register the modules
-        await _commands.AddModulesAsync(Assembly.GetEntryAssembly(), _services);
-    }
-
-    public async Task CommandHandleAsync(SocketMessage msg)
-    {
-        // ...
-    }
-}

docs/guides/commands/samples/typereaders/typereader.cs

@@ -1,16 +0,0 @@
-// Note: This example is obsolete, a boolean type reader is bundled 
-// with Discord.Commands
-using Discord;
-using Discord.Commands;
-
-public class BooleanTypeReader : TypeReader
-{
-    public override Task<TypeReaderResult> ReadAsync(ICommandContext context, string input, IServiceProvider services)
-    {
-        bool result;
-        if (bool.TryParse(input, out result))
-            return Task.FromResult(TypeReaderResult.FromSuccess(result));
-
-        return Task.FromResult(TypeReaderResult.FromError(CommandError.ParseFailed, "Input could not be parsed as a boolean."));
-    }
-}