188 Style Conformance for Using jQ Core Section

README.md

@@ -10,21 +10,20 @@ The goal of this site is twofold:
 1. To serve as a central, trustworthy, narrative compendium of information about how to use jQuery and JavaScript.
 2. To remain a timely, vibrant, and community-driven reference with a low barrier to contribution.
 
-Much of the initial content - and spirit - comes from [jQuery Fundamentals](https://github.com/rmurphey/jqfundamentals), an open-source book about jQuery, originally written by [Rebecca Murphey](http://www.rmurphey.com/) and released in 2010. In 2011, Rebecca [bequeathed the book](http://rmurphey.com/blog/2011/03/17/the-future-of-jquery-fundamentals-and-a-confession/) unto the jQuery Project to serve as the foundation for this site.
+Much of the initial content - and spirit - comes from [jQuery Fundamentals](https://github.com/rmurphey/jqfundamentals), an open-source book about jQuery, originally written by [Rebecca Murphey](http://www.rmurphey.com/) and released in 2010. In 2011, Rebecca [bequeathed the book](http://rmurphey.com/blog/2011/03/17/the-future-of-jquery-fundamentals-and-a-confession/) unto the jQuery Foundation to serve as the basis for this site.
 
 
 ## How This Site Works
 
-This site's core content consists of [Markdown](http://daringfireball.net/projects/markdown/) files. We use [nanoc](http://nanoc.stoneship.org/), a Ruby-based [static site generator](http://www.mickgardner.com/2011/04/27/An-Introduction-To-Static-Site-Generators.html), to process these files for previewing. For production on [learn.jquery.com](http://learn.jquery.com), a node.js script post-processes the nanoc results and puts them into the learning section of the jQuery Wordpress network.
-
-The template that controls the site's appearance is a [child theme](https://github.com/jquery/web-base-template/tree/master/themes/learn-jquery-com) of the jQuery [web base template](https://github.com/jquery/web-base-template), and any issues with the presentation should be directed to [that repository](https://github.com/jquery/web-base-template).
+This site's core content consists of [Markdown](http://daringfireball.net/projects/markdown/) files. The template that controls the site's appearance is a [child theme](https://github.com/jquery/web-base-template/tree/master/themes/learn-jquery-com) of the jQuery [web base template](https://github.com/jquery/web-base-template), and any issues with the presentation should be directed to [that repository](https://github.com/jquery/web-base-template).
 
 ### Site Organization
 
-All of the content lives inside of the subdirectories of the `content` directory. Each of these subdirectories is considered a **category**, and contains one or more **articles**. Each category also contains a `dex.md` file that contains the category's human-readable title and an overview, which will appear on the category's landing page.
+All of the content lives inside of the subdirectories of the `page` directory. Each of these subdirectories is considered a **category**, and contains one or more **articles**, and there is also a top level file that corresponds to each category, which contains the category's human-readable title and an overview, which will appear on the category's landing page.
 
 An [`order.yml`](https://github.com/jquery/learn.jquery.com/blob/master/order.yml) file controls the order that categories and articles appear in the site. Categories or articles that do not appear in this file will not be published in the production site.
 
+
 ### YAML Conventions
 
 Each of the articles on the site has some [YAML "Front Matter"](https://github.com/mojombo/jekyll/wiki/YAML-Front-Matter) that contains metadata. All articles should include the following:

config-sample.json

@@ -1,5 +1,5 @@
 {
-	"url": "dev.learn.jquery.com",
+	"url": "local.learn.jquery.com",
 	"username": "admin",
 	"password": "sample"
 }

grunt.js

@@ -8,6 +8,7 @@ grunt.loadNpmTasks( "grunt-clean" );
 grunt.loadNpmTasks( "grunt-html" );
 grunt.loadNpmTasks( "grunt-wordpress" );
 grunt.loadNpmTasks( "grunt-jquery-content" );
+grunt.loadNpmTasks( "grunt-check-modules" );
 
 grunt.initConfig({
 	clean: {
@@ -44,7 +45,7 @@ grunt.initConfig({
 });
 
 grunt.registerTask( "default", "wordpress-deploy" );
-grunt.registerTask( "build-wordpress", "clean lint build-pages build-resources");
+grunt.registerTask( "build-wordpress", "check-modules clean lint build-pages build-resources");
 grunt.registerTask( "deploy", "wordpress-deploy" );
 
 };

package.json

@@ -25,6 +25,7 @@
 		"grunt-clean": "0.3.0",
 		"grunt-html": "0.1.1",
 		"grunt-wordpress": "1.0.3",
-		"grunt-jquery-content": "0.5.9"
+		"grunt-jquery-content": "0.5.10",
+		"grunt-check-modules": "0.1.0"
 	}
 }

page/about-jquery/how-jquery-works.md

@@ -31,7 +31,7 @@ can use:
   <script src="jquery.js"></script>
 ```
 
-You can download your own copy of jQuery from the [Downloading jQuery](http://jquery.com/download/) page
+Download a copy of jQuery from the [Downloading jQuery](http://jquery.com/download/) page.
 
 ### Launching Code on Document Ready
 The first thing that most Javascript programmers end up doing is adding some code to their program, similar to this:
@@ -42,7 +42,7 @@ window.onload = function() {
 
 }
 ```
-Inside of which is the code that you want to run right when the page is loaded. Problematically, however, the Javascript code isn't run until all images are finished downloading (this includes banner ads). The reason for using window.onload in the first place is that the HTML 'document' isn't finished loading yet, when you first try to run your code.
+Inside of which is the code that you want to run right when the page is loaded. Problematically, however, the Javascript code isn't run until all images are finished downloading (this includes banner ads). The reason for using `window.onload` in the first place is that the HTML 'document' isn't finished loading yet, when you first try to run your code.
 
 To circumvent both problems, jQuery has a simple statement that checks the `document` and waits until it's ready to be manipulated, known as the [ ready event ](http://api.jquery.com/ready):
 
@@ -91,11 +91,11 @@ The following is an example of what the complete HTML file might look like if
 you were to use the script in your own file. Note that it links to Google's
 [CDN](http://code.google.com/apis/libraries/) to load the jQuery core file.
 Also, while the custom script is included in the `<head>`, it is generally
-preferable to place it in a separate file and refer that file with the script
-element's src attribute
+preferable to place it in a separate file and refer to that file with the script
+element's `src` attribute.
 
 ```
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
 <head>
   <meta charset="utf-8">
@@ -129,7 +129,7 @@ element's src attribute
 
 Another common task is adding (or removing) a `class`.
 
-First, add some style information into the `head` of your document, like this:
+First, add some style information into the `head` of the document, like this:
 
 ```
 <style>
@@ -139,15 +139,15 @@ First, add some style information into the `head` of your document, like this:
 </style>
 ```
 
-Next, add the [addClass](http://api.jquery.com/addClass) call to your script:
+Next, add the [addClass](http://api.jquery.com/addClass) call to the script:
 
 ```
 $("a").addClass("test");
 ```
 
-All your `a` elements will now be bold.
+All `a` elements will now be bold.
 
-To remove the `class`, use [removeClass](http://api.jquery.com/removeClass)
+To remove the `class`, use [removeClass](http://api.jquery.com/removeClass):
 
 ```
 $("a").removeClass("test");
@@ -156,8 +156,8 @@ $("a").removeClass("test");
 ### Special Effects
 
 In jQuery, a couple of handy [effects](http://api.jquery.com/category/effects/)
-are provided, to really make your web site stand out. To put this to the test,
-change the click that you added earlier to this:
+are provided, to really make web sites stand out. For example,
+change the click you added earlier to the following:
 
 ```
 $("a").click(function( event ){
@@ -169,29 +169,29 @@ $("a").click(function( event ){
 });
 ```
 
-Now, if you click any link, it should make itself slowly disappear.
+Now, the link should slowly disappear when clicked.
 
-## Callback and Functions
+## Callbacks and Functions
 
 A callback is a function that is passed as an argument to another function and
 is executed after its parent function has completed. The special thing about a
 callback is that functions that appear after the "parent" can execute before
 the callback executes.  Another important thing to know is how to properly pass
 the callback.
 
-### Callback *without* arguments
+### Callback *without* Arguments
 
-For a callback with no arguments you pass it like this:
+Pass callbacks with no arguments like this:
 
 ```
 $.get( "myhtmlpage.html", myCallBack );
 ```
 
-**Note** that the second parameter here is simply the function name (but *not* as a string and without parentheses). Functions in Javascript are 'First class citizens' and so can be passed around like variable references and executed at a later time.
+**Note** that the second parameter here is simply the function name (but *not* as a string and without parentheses). Functions in Javascript are 'First class citizens' and can be passed around like variable references and executed at a later time.
 
-### Callback *with* arguments
+### Callback *with* Arguments
 
-"What do you do if you have arguments that you want to pass?", you might ask yourself.
+Executing callbacks with arguments can be tricky. The below example illustrates how to think about callbacks with arguments:
 
 #### Wrong
 The Wrong Way (will ***not*** work!)
@@ -201,18 +201,15 @@ $.get( "myhtmlpage.html", myCallBack(param1, param2) );
 ```
 
 
-This will not work because it calls `myCallBack( param1, param2 )`
-
-
-and then passes the return value as the second parameter to [$.get()](http://api.jquery.com/jQuery.get/)
+This will not work because it calls `myCallBack( param1, param2 )` and then passes the return value as the second parameter to [$.get()](http://api.jquery.com/jQuery.get/).
 
 #### Right
 
 The problem with the above example is that `myCallBack( param1, param2 )` is
-evaluated before being passed as a function. Javascript and by extension jQuery
-expects a function pointer in cases like these, e.g., `setTimeout( function() {}, 100)`
+evaluated before being passed as a function. Javascript (and by extension, jQuery)
+expects a function pointer in cases like these, e.g., `setTimeout( function() {}, 100)`.
 
-In the below usage, an anonymous function is created (just a block of
+In the example below, an anonymous function is created (just a block of
 statements) and is registered as the callback function.  Note the use of
 `function() {`.  The anonymous function does exactly one thing:  calls
 `myCallBack`, with the values of `param1` and `param2` from the outer scope.