style conformance for using-jquery-core/understanding-index

page/using-jquery-core/understanding-index.md

@@ -1,12 +1,13 @@
 ---
-title   : using jQuery's index() function
+title   : Using jQuery's .index() Function
 level: intermediate
+source:  http://jsfiddle.net/johnkpaul/SrHDh/
+attribution: 
+  - John Paul
 ---
-## .index()
+`.index()` is a method on jQuery objects that's generally used to search for a given element within the jQuery object that it's called on. This method has four different signatures with different semantics that can be confusing. This article covers details about how to understand the way `.index()` works with each signature.
 
-`index()` is a method on jQuery objects that is generally used to search for a given element within the jQuery object that it is called on. This method has four different signatures with different semantics that can potentially cause confusion. This chapter will describe the details for how to understand how `.index()` works with each signature.
-
-### `index()` with no arguments
+## `.index()` with No Arguments
 
 ```
 <ul>
@@ -37,13 +38,11 @@ console.log( "Index: " + $div.index() );  // 4
 
 console.log( "Index: " + $div.last().index() ); // 4
 ```
-[jsFiddle demo](http://jsfiddle.net/johnkpaul/SrHDh)
-
-In the first example, `index()` gives the zero-based index of `#foo1` within it's parent. since `#foo1` is the second child of it's parent, `index()` returns 1.
+In the first example, `.index()` gives the zero-based index of `#foo1` within its parent. Since `#foo1` is the second child of its parent, `index()` returns 1.
 
-The first potential confusion comes from the other examples in this fiddle.  When `index()` is called on a jquery object that contains more than one element, it does not calculate the index of the first element, as I would have expected, but rather calculates the index of the last element. This is equivalent to always calling `$jqObject.last().index();`
+Potential confusion comes from the other examples of `.index()` in the above code.  When `.index()` is called on a jQuery object that contains more than one element, it does not calculate the index of the first element as might be expected, but instead calculates the index of the last element. This is equivalent to always calling `$jqObject.last().index();`.
 
-### `index()` with a string argument
+## `.index()` with a String Argument
 
 ```
 <ul>
@@ -71,13 +70,11 @@ var $div = $("#last");
 console.log( "Index: " + $div.index("div") ); // 2
 ```
 
-[jsFiddle demo](http://jsfiddle.net/johnkpaul/D29cZ/)
-
-When `index()` is called with a string argument, there are two things to consider. The first is that jQuery will implicitly call `.first()` on the original jQuery object. It will be finding the index of the first element, not the last element in this case. This inconsistency always makes me stop and think, so be careful with this one.
+When `.index()` is called with a string argument, there are two things to consider. First, jQuery will implicitly call `.first()` on the original jQuery object. It will be find the index of the first element, not the last element in this case. This is inconsist, so be careful here.
 
-The second point is that jQuery is querying the entire dom using the passed in string selector and checking the index within that newly queried jQuery object. For example, when using `.index("div")` in the last example, jQuery is selecting all of the divs in the document, and then searching for the index that contains the first element in the jquery object that `.index()` is called on.
+The second point to consider is that jQuery is querying the entire DOM using the passed in string selector and checking the index within that newly queried jQuery object. For example, when using `.index("div")` in the last example above, jQuery is selecting all of the `<divs>` in the document, then searching for the index that contains the first element in the jQuery object `.index()` is called on.
 
-### `index()` with a jQuery object argument
+## `.index()` with a jQuery Object Argument
 
 ```
 <ul>
@@ -105,11 +102,8 @@ console.log( "Index: " + $tests.index($bar) ); // 1
 console.log( "Index: " + $tests.index($bar.first()) ); // 1
 ```
 
-[jsFiddle demo](http://jsfiddle.net/johnkpaul/QZv7y/)
-
-
 In this case, the first element of the jQuery object that is passed into `.index()` is being checked against all of the elements in the original jQuery object.  The original jQuery object, on the left side of `.index()`, is array-like and is searched from index 0 through `length - 1` for the first element of the argument jQuery object.
 
-### `index()` with a DOM element argument
+## `.index()` with a DOM Element Argument
 
-In this case, the DOM element that is passed into `.index()` is being checked against all of the elements in the original jQuery object. Once all of the other cases are understood, this should be the simplest case. It is very similar to the previous case, except since the DOM element is passed directly, it is not taken from a jQuery object container.
+In this case, the DOM element that's passed into `.index()` is being checked against all of the elements in the original jQuery object. Once all other cases are understood, this should be the simplest case. It is very similar to the previous case, except since the DOM element is passed directly, it is not taken from a jQuery object container.