From e36a1707494ad032d849801c4f41fa03da9d16df Mon Sep 17 00:00:00 2001
From: RunDevelopment <mitchi5000.ms@googlemail.com>
Date: Sat, 21 Nov 2020 16:39:40 +0100
Subject: [PATCH 1/2] Unescaped Markup: More doc regarding comments

---
 plugins/unescaped-markup/index.html | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/plugins/unescaped-markup/index.html b/plugins/unescaped-markup/index.html
index 5efc7ab795..240fec2785 100644
--- a/plugins/unescaped-markup/index.html
+++ b/plugins/unescaped-markup/index.html
@@ -24,15 +24,23 @@ <h1>How to use</h1>
 	<p>This plugin provides several methods of achieving the same thing:</p>
 
 	<ul>
-		<li>Instead of using <code>&lt;pre>&lt;code></code> elements, use <code>&lt;script type="text/plain"></code>
-		<pre><code>&lt;script type="text/plain" class="language-markup">
+		<li>
+			Instead of using <code>&lt;pre>&lt;code></code> elements, use <code>&lt;script type="text/plain"></code>:
+
+			<pre><code>&lt;script type="text/plain" class="language-markup">
 &lt;p>Example&lt;/p>
 &lt;/script></code></pre>
 		</li>
-		<li>Use a HTML-comment to escape your code
-		<pre><code>&lt;pre class="language-markup">&lt;code>&lt;!--
+		<li>
+			Use a HTML-comment to escape your code:
+
+			<pre><code>&lt;pre class="language-markup">&lt;code>&lt;!--
 &lt;p>Example&lt;/p>
--->&lt;/code>&lt;/pre></code></pre></li>
+-->&lt;/code>&lt;/pre></code></pre>
+
+			This will only work if the <code>code</code> element contains exactly one comment and nothing else (not even spaces).
+			E.g. <code>&lt;code>  &lt;!-- some text -->&lt;/code></code> and <code>&lt;code>text&lt;!-- more text -->&lt;/code></code> will not work.
+		</li>
 	</ul>
 </section>
 

From 6b801f1fc463000d3b6579009aaf7b6e6d4ebd84 Mon Sep 17 00:00:00 2001
From: Michael Schmidt <mitchi5000.ms@googlemail.com>
Date: Sat, 28 Nov 2020 23:08:35 +0100
Subject: [PATCH 2/2] Update plugins/unescaped-markup/index.html

Co-authored-by: James DiGioia <jamesorodig@gmail.com>
---
 plugins/unescaped-markup/index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plugins/unescaped-markup/index.html b/plugins/unescaped-markup/index.html
index 240fec2785..a0309096e8 100644
--- a/plugins/unescaped-markup/index.html
+++ b/plugins/unescaped-markup/index.html
@@ -32,7 +32,7 @@ <h1>How to use</h1>
 &lt;/script></code></pre>
 		</li>
 		<li>
-			Use a HTML-comment to escape your code:
+			Use an HTML-comment to escape your code:
 
 			<pre><code>&lt;pre class="language-markup">&lt;code>&lt;!--
 &lt;p>Example&lt;/p>