From 855815911ede49db171a80700902f8e27f465812 Mon Sep 17 00:00:00 2001
From: Michael Kelly <michaelkelly322@gmail.com>
Date: Mon, 4 Mar 2019 11:58:07 -0500
Subject: [PATCH 1/3] Add deprecation clause to connection include

---
 lib/graphql-docs/layouts/includes/connections.html | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/lib/graphql-docs/layouts/includes/connections.html b/lib/graphql-docs/layouts/includes/connections.html
index 4e5c3a1..262d28b 100644
--- a/lib/graphql-docs/layouts/includes/connections.html
+++ b/lib/graphql-docs/layouts/includes/connections.html
@@ -4,7 +4,15 @@
   <span id="<%= slugify.(connection[:name]) %>" class="field-name connection-name anchored"><%= connection[:name] %> (<code><a href="<%= base_url %>/<%= connection[:type][:path] %>"><%= connection[:type][:info] %></a></code>)</span>
 
   <div class="description-wrapper">
+    <% if connection[:is_deprecated] %>
+      <div class="deprecation-notice <%= classes[:deprecation_notice] %>">
+        <span class="deprecation-title">Deprecation notice</span>
+        <%= markdownify.(connection[:deprecation_reason]) %>
+      </div>
+    <% end %>
+
     <%= include.('notices.html', notices: connection[:notices]) %>
+
     <p><%= connection[:description] %></p>
 
     <% unless connection[:arguments].empty? %>

From b11e9aa624657b1ad1c51db6af20cd38c80a5e67 Mon Sep 17 00:00:00 2001
From: Michael Kelly <michaelkelly322@gmail.com>
Date: Mon, 4 Mar 2019 12:00:53 -0500
Subject: [PATCH 2/3] Parse markdown on connection field descriptions

---
 lib/graphql-docs/layouts/includes/connections.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/graphql-docs/layouts/includes/connections.html b/lib/graphql-docs/layouts/includes/connections.html
index 262d28b..e92955c 100644
--- a/lib/graphql-docs/layouts/includes/connections.html
+++ b/lib/graphql-docs/layouts/includes/connections.html
@@ -13,7 +13,7 @@
 
     <%= include.('notices.html', notices: connection[:notices]) %>
 
-    <p><%= connection[:description] %></p>
+    <p><%= markdownify.(connection[:description]) %></p>
 
     <% unless connection[:arguments].empty? %>
       <%= include.('arguments.html', arguments: connection[:arguments]) %>

From 677e82d8a38bf0cb4b9e7a9b243e6fa17281590b Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 4 Mar 2019 12:54:19 -0500
Subject: [PATCH 3/3] Standerdized deprecation notices

---
 .../layouts/includes/connections.html          |  9 ++-------
 .../layouts/includes/deprecations.html         |  6 ++++++
 lib/graphql-docs/layouts/includes/fields.html  | 18 ++++++------------
 lib/graphql-docs/layouts/includes/values.html  | 11 +++--------
 4 files changed, 17 insertions(+), 27 deletions(-)
 create mode 100644 lib/graphql-docs/layouts/includes/deprecations.html

diff --git a/lib/graphql-docs/layouts/includes/connections.html b/lib/graphql-docs/layouts/includes/connections.html
index e92955c..66e442e 100644
--- a/lib/graphql-docs/layouts/includes/connections.html
+++ b/lib/graphql-docs/layouts/includes/connections.html
@@ -4,16 +4,11 @@
   <span id="<%= slugify.(connection[:name]) %>" class="field-name connection-name anchored"><%= connection[:name] %> (<code><a href="<%= base_url %>/<%= connection[:type][:path] %>"><%= connection[:type][:info] %></a></code>)</span>
 
   <div class="description-wrapper">
-    <% if connection[:is_deprecated] %>
-      <div class="deprecation-notice <%= classes[:deprecation_notice] %>">
-        <span class="deprecation-title">Deprecation notice</span>
-        <%= markdownify.(connection[:deprecation_reason]) %>
-      </div>
-    <% end %>
+    <%= include.('deprecations.html', item: connection) %>
 
     <%= include.('notices.html', notices: connection[:notices]) %>
 
-    <p><%= markdownify.(connection[:description]) %></p>
+    <%= markdownify.(connection[:description]) %>
 
     <% unless connection[:arguments].empty? %>
       <%= include.('arguments.html', arguments: connection[:arguments]) %>
diff --git a/lib/graphql-docs/layouts/includes/deprecations.html b/lib/graphql-docs/layouts/includes/deprecations.html
new file mode 100644
index 0000000..c8290c4
--- /dev/null
+++ b/lib/graphql-docs/layouts/includes/deprecations.html
@@ -0,0 +1,6 @@
+<% if item[:is_deprecated] %>
+<div class="deprecation-notice <%= classes[:deprecation_notice] %>">
+  <span class="deprecation-title">Deprecation notice</span>
+  <%= markdownify.(item[:deprecation_reason]) %>
+</div>
+<% end %>
diff --git a/lib/graphql-docs/layouts/includes/fields.html b/lib/graphql-docs/layouts/includes/fields.html
index 9c1a97c..57d5695 100644
--- a/lib/graphql-docs/layouts/includes/fields.html
+++ b/lib/graphql-docs/layouts/includes/fields.html
@@ -4,21 +4,15 @@
   <span id="<%= slugify.(field[:name]) %>" class="field-name anchored"><%= field[:name] %> (<code><a href="<%= base_url %>/<%= field[:type][:path] %>"><%= field[:type][:info] %></a></code>)</span>
 
   <div class="description-wrapper">
-  <% if field[:is_deprecated] %>
-    <div class="deprecation-notice <%= classes[:deprecation_notice] %>">
-      <span class="deprecation-title">Deprecation notice</span>
-      <%= markdownify.(field[:deprecation_reason]) %>
-    </div>
-  <% end %>
+    <%= include.('deprecations.html', item: field) %>
 
-  <%= include.('notices.html', notices: field[:notices]) %>
+    <%= include.('notices.html', notices: field[:notices]) %>
 
-  <%= markdownify.(field[:description]) %>
-
-  <% unless field[:arguments].empty? %>
-    <%= include.('arguments.html', arguments: field[:arguments]) %>
-  <% end %>
+    <%= markdownify.(field[:description]) %>
 
+    <% unless field[:arguments].empty? %>
+      <%= include.('arguments.html', arguments: field[:arguments]) %>
+    <% end %>
   </div>
 </div>
 
diff --git a/lib/graphql-docs/layouts/includes/values.html b/lib/graphql-docs/layouts/includes/values.html
index ebe5e6a..6b333a7 100644
--- a/lib/graphql-docs/layouts/includes/values.html
+++ b/lib/graphql-docs/layouts/includes/values.html
@@ -5,16 +5,11 @@ <h3 id="fields">Values</h3>
   <h4 id="<%= slugify.(value[:name]) %>" class="name anchored"><%= value[:name] %></h4>
 
   <div class="description-wrapper">
-    <%= include.('notices.html', notices: value[:notices]) %>
+    <%= include.('deprecations.html', item: value) %>
 
-    <% if value[:is_deprecated] %>
-      <div class="deprecation-notice <%= classes[:deprecation_notice] %>">
-        <span class="deprecation-title">Deprecation notice</span>
-        <%= markdownify.(value[:deprecation_reason]) %>
-      </div>
-    <% end %>
+    <%= include.('notices.html', notices: value[:notices]) %>
 
-    <p><%= value[:description] %></p>
+    <%= markdownify.(value[:description]) %>
   </div>
 
 <% end %>