From 9bd5f9c0cdafbc83ddd897fd82ea17dd09eef9e7 Mon Sep 17 00:00:00 2001
From: Niels de Blaauw <niels@level-level.com>
Date: Thu, 31 Oct 2019 13:47:42 +0100
Subject: [PATCH] Adds documentation for WordPress.WP.EnqueuedResources.

---
 .../Docs/WP/EnqueuedResourcesStandard.xml     | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 WordPress/Docs/WP/EnqueuedResourcesStandard.xml

diff --git a/WordPress/Docs/WP/EnqueuedResourcesStandard.xml b/WordPress/Docs/WP/EnqueuedResourcesStandard.xml
new file mode 100644
index 0000000000..3857df3d7c
--- /dev/null
+++ b/WordPress/Docs/WP/EnqueuedResourcesStandard.xml
@@ -0,0 +1,53 @@
+<documentation title="Enqueued Resources">
+    <standard>
+    <![CDATA[
+    Scripts must be registered/enqueued via wp_enqueue_script().
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Script registered and enqueued correctly.">
+        <![CDATA[
+<em>wp_enqueue_script</em>( 
+    'someScript-js', 
+    $path_to_file, 
+    array( 'jquery' ),
+    '1.0.0',
+    true
+);
+        ]]>
+        </code>
+        <code title="Invalid: Script is directly embedded in HTML.">
+        <![CDATA[
+printf( 
+    '<em><script src="%s"></script></em>',
+    esc_url( $path_to_file )
+);
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Stylesheets must be registered/enqueued via wp_enqueue_style().
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Stylesheet registered and enqueued correctly.">
+        <![CDATA[
+<em>wp_enqueue_style</em>( 
+    'style-name', 
+    $path_to_file, 
+    array(), 
+    '1.0.0'
+);
+        ]]>
+        </code>
+        <code title="Invalid: Stylesheet is directly embedded in HTML.">
+        <![CDATA[
+printf( 
+    '<em><link rel="stylesheet" href="%s" /></em>',
+    esc_url( $path_to_file )
+);
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>