From 27e6e2bdbf2ae050b564bfa2246ece65178825d2 Mon Sep 17 00:00:00 2001
From: Hsu Still <341464@gmail.com>
Date: Tue, 3 Apr 2018 08:27:04 +0800
Subject: [PATCH] Add PreconditionAttribute docs

---
 .../PreconditionAttribute.Overwrites.md       | 30 +++++++++++++++++++
 ...PreconditionAttribute.Remarks.Inclusion.md |  6 ++++
 .../OverrideTypeReaderAttribute.Overwrites.md | 24 +++++++++++++++
 3 files changed, 60 insertions(+)
 create mode 100644 docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md
 create mode 100644 docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md
 create mode 100644 docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md

diff --git a/docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md b/docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md
new file mode 100644
index 000000000..343547b47
--- /dev/null
+++ b/docs/_overwrites/Commands/PreconditionAttribute.Overwrites.md
@@ -0,0 +1,30 @@
+---
+uid: Discord.Commands.PreconditionAttribute
+seealso:
+    - linkId: Discord.Commands.ParameterPreconditionAttribute
+remarks: *content
+---
+
+This precondition attribute can be applied on module-level or
+method-level for a command.
+
+[!include[Remarks(PreconditionAttribute.Remarks.Inclusion.md)]]
+
+---
+uid: Discord.Commands.ParameterPreconditionAttribute
+seealso:
+    - linkId: Discord.Commands.PreconditionAttribute
+remarks: *content
+---
+
+This precondition attribute can be applied on parameter-level for a
+command.
+
+[!include[Remarks(PreconditionAttribute.Remarks.Inclusion.md)]]
+
+---
+uid: Discord.Commands.PreconditionAttribute
+example: [*content]
+---
+
+// todo: add example
\ No newline at end of file
diff --git a/docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md b/docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md
new file mode 100644
index 000000000..499cdb0ad
--- /dev/null
+++ b/docs/_overwrites/Commands/PreconditionAttribute.Remarks.Inclusion.md
@@ -0,0 +1,6 @@
+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.
\ No newline at end of file
diff --git a/docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md b/docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md
new file mode 100644
index 000000000..29b547e49
--- /dev/null
+++ b/docs/_overwrites/Common/OverrideTypeReaderAttribute.Overwrites.md
@@ -0,0 +1,24 @@
+---
+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)
+{
+    //...
+}
+```
\ No newline at end of file