From 953c3ba4b35d87d8266c0c4c840f2d17c3bb457f Mon Sep 17 00:00:00 2001
From: Ben Word <ben@benword.com>
Date: Sun, 15 Jul 2012 21:17:22 -0500
Subject: [PATCH] Update code comments

---
 inc/scripts.php | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/inc/scripts.php b/inc/scripts.php
index 9a9ec5b..f7559f0 100644
--- a/inc/scripts.php
+++ b/inc/scripts.php
@@ -1,6 +1,18 @@
 <?php
 /**
  * Scripts and stylesheets
+ *
+ * Enqueue stylesheets in the following order:
+ * 1. /theme/css/bootstrap.css
+ * 2. /theme/css/bootstrap-responsive.css      (if enabled in config.php)
+ * 3. /theme/css/app.css
+ * 4. /child-theme/style.css                   (if a child theme is activated)
+ *
+ * Enqueue scripts in the following order:
+ * 1. /theme/js/vendor/modernizr-2.5.3.min.js  (in header.php)
+ * 2. jquery-1.7.2.min.js via Google CDN       (in header.php)
+ * 3. /theme/js/plugins.js
+ * 4. /theme/js/main.js
  */
 
 function roots_scripts() {
@@ -10,7 +22,7 @@ function roots_scripts() {
     wp_enqueue_style('roots_bootstrap_responsive', get_template_directory_uri() . '/css/bootstrap-responsive.css', array('roots_bootstrap'), null);
   }
 
-  // If you're not using Bootstrap, include H5BP's main.css:
+  // If you're not using Bootstrap, include HTML5 Boilerplate's main.css:
   // wp_enqueue_style('roots_h5bp', get_template_directory_uri() . '/css/main.css', false, null);
 
   wp_enqueue_style('roots_app', get_template_directory_uri() . '/css/app.css', false, null);
@@ -20,6 +32,9 @@ function roots_scripts() {
     wp_enqueue_style('roots_child', get_stylesheet_uri(), false, null);
   }
 
+  // jQuery is loaded in header.php using the same method from HTML5 Boilerplate:
+  // Grab Google CDN's jQuery, with a protocol relative URL; fall back to local if offline
+  // It's kept in the header instead of footer to avoid conflicts with plugins.
   if (!is_admin()) {
     wp_deregister_script('jquery');
     wp_register_script('jquery', '', '', '', false);