From 55349f4a2744fbcbd17521e69472423758a127fc Mon Sep 17 00:00:00 2001
From: Sam Harwell <sam@tunnelvisionlabs.com>
Date: Sun, 5 Jul 2020 13:41:11 -0700
Subject: [PATCH] Enable documentation comment analysis

---
 Directory.Build.props   | 27 +++++++++++++++++++++++++++
 Directory.Build.targets |  3 +++
 2 files changed, 30 insertions(+)
 create mode 100644 Directory.Build.props
 create mode 100644 Directory.Build.targets

diff --git a/Directory.Build.props b/Directory.Build.props
new file mode 100644
index 00000000..4bf85d50
--- /dev/null
+++ b/Directory.Build.props
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project>
+
+  <PropertyGroup>
+    <!--
+      Make sure any documentation comments which are included in code get checked for syntax during the build, but do
+      not report warnings for missing comments.
+
+      CS1573: Parameter 'parameter' has no matching param tag in the XML comment for 'parameter' (but other parameters do)
+      CS1591: Missing XML comment for publicly visible type or member 'Type_or_Member'
+      CS1712: Type parameter 'type_parameter' has no matching typeparam tag in the XML comment on 'type_or_member' (but other type parameters do)
+    -->
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn),1573,1591,1712</NoWarn>
+
+    <!--
+      Suppress warnings for currently-invalid documentation comments.
+
+      CS1570: XML comment has badly formed XML
+      CS1572: XML comment has a param tag, but there is no parameter by that name
+      CS1587: XML comment is not placed on a valid language element
+      CS1711: XML comment has a typeparam tag, but there is no type parameter by that name
+    -->
+    <NoWarn>$(NoWarn),1570,1572,1587,1711</NoWarn>
+  </PropertyGroup>
+
+</Project>
diff --git a/Directory.Build.targets b/Directory.Build.targets
new file mode 100644
index 00000000..341027f3
--- /dev/null
+++ b/Directory.Build.targets
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project>
+</Project>