Adding Entity guides, flowcharts, better sample system. (#2054)

* initial

* Interaction glossary entry

* Sharded Interaction sample

* Renames into solution

* Debugging samples

* Modify target location for webhookclient

* Finalizing docs work, resolving docfx errors.

* Adding threaduser to user chart

* Add branch info to readme.

* Edits to user chart

* Resolve format for glossary entries

* Patch sln target

* Issue with file naming fixed

* Patch 1/x for builds

* Appending suggestions

samples/InteractionFramework/Attributes/DoUserCheckAttribute.cs

@@ -0,0 +1,37 @@
+using Discord;
+using Discord.Interactions;
+using Discord.WebSocket;
+using System;
+using System.Threading.Tasks;
+
+namespace InteractionFramework.Attributes
+{
+    internal class DoUserCheck : PreconditionAttribute
+    {
+        public override Task<PreconditionResult> CheckRequirementsAsync(IInteractionContext context, ICommandInfo commandInfo, IServiceProvider services)
+        {
+            // Check if the component matches the target properly.
+            if (context.Interaction is not SocketMessageComponent componentContext)
+                return Task.FromResult(PreconditionResult.FromError("Context unrecognized as component context."));
+
+            else
+            {
+                // The approach here entirely depends on how you construct your custom ID. In this case, the format is:
+                // unique-name:*,*
+
+                // here the name and wildcards are split by ':'
+                var param = componentContext.Data.CustomId.Split(':');
+
+                // here we determine that we should always check for the first ',' present.
+                // This will deal with additional wildcards by always selecting the first wildcard present.
+                if (param.Length > 1 && ulong.TryParse(param[1].Split(',')[0], out ulong id))
+                    return (context.User.Id == id)
+                        // If the user ID
+                        ? Task.FromResult(PreconditionResult.FromSuccess())
+                        : Task.FromResult(PreconditionResult.FromError("User ID does not match component ID!"));
+
+                else return Task.FromResult(PreconditionResult.FromError("Parse cannot be done if no userID exists."));
+            }
+        }
+    }
+}

samples/InteractionFramework/Attributes/RequireOwnerAttribute.cs

@@ -0,0 +1,27 @@
+using Discord;
+using Discord.Interactions;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace InteractionFramework.Attributes
+{
+    public class RequireOwnerAttribute : PreconditionAttribute
+    {
+        public override async Task<PreconditionResult> CheckRequirementsAsync (IInteractionContext context, ICommandInfo commandInfo, IServiceProvider services)
+        {
+            switch (context.Client.TokenType)
+            {
+                case TokenType.Bot:
+                    var application = await context.Client.GetApplicationInfoAsync().ConfigureAwait(false);
+                    if (context.User.Id != application.Owner.Id)
+                        return PreconditionResult.FromError(ErrorMessage ?? "Command can only be run by the owner of the bot.");
+                    return PreconditionResult.FromSuccess();
+                default:
+                    return PreconditionResult.FromError($"{nameof(RequireOwnerAttribute)} is not supported by this {nameof(TokenType)}.");
+            }
+        }
+    }
+}