Further attempt to dissuade this feature's use

anto-deepsource · Mar 15, 2018 · e4c5be0 · e4c5be0
1 parent e6444bb
commit e4c5be0
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/test/UnsafeExtension.php b/test/UnsafeExtension.php
@@ -7,6 +7,11 @@ protected function blockFencedCodeComplete($Block)
         $text = $Block['element']['text']['text'];
         unset($Block['element']['text']['text']);
 
+        // WARNING: There is almost always a better way of doing things!
+        //
+        // This example is one of them, unsafe behaviour is NOT needed here.
+        // Only use this if you trust the input and have no idea what
+        // the output HTML will look like (e.g. using an external parser).
         $Block['element']['text']['unsafeHtml'] = "<p>$text</p>";
 
         return $Block;