Core Docs: Update docs for 1.8

[kswedberg]

Use the jQuery 1.8 Release blog entry as a reference. Pay careful attention to items in the "jQuery 1.8 Change Log."

Let's first post each change as an issue over at https://github.com/jquery/api.jquery.com so we can keep track of what we're doing.

[dmethvin]

Thanks Karl. For 1.9 I plan to build something similar to the UI 1.9 Upgrade Guide as we go along so that it won't be so painful.

[kswedberg]

That would be awesome. Thanks, Dave. No excuse, though. I totally dropped the ball on the 1.8 doc updates.

[kswedberg]

P.S. to all Table 4 peeps: 1.8 animation docs should be high priority. See https://github.com/jquery/api.jquery.com/issues/81 for details. Also, I started adding the new methods to the options object in a commit to the animate-1.8 branch. I'll merge it in after @gnarf37 has a chance to review it.

[kswedberg]

PPS: I trimmed down the change log list to just those items that could possibly need documentation:

Ajax

#9399: Deprecate jqXHR.success and jqXHR.error #11013: Deprecate use of Deferred/Promise with sync $.ajax #12122: jQuery.ajax() async deprecate use with $.Deferred

Core

#10657: Deprecate jQuery#size() in favor of jQuery#length #12026: Let $(html, props) use any jQuery.fn method

CSS

#10679: CSS3 vendor prefix support

Data

#10589: Remove $.fn.data("events")

Deferred

#11010: Make Deferred.then == Deferred.pipe like Promise/A #11011: Allow traditional options object for $.Callbacks flags #11736: Remove Deferred .isResolved() and .isRejected() #11749: Preserve context objects when multiple Deferred object are passed to $.when()

Dimensions

#10877: Make outerWidth/Height a setter #11604: Switch $(elem).width(-val) from no-op to $(elem).width(0)

Effects

#11797: New animation related events (See https://github.com/jquery/api.jquery.com/issues/81)

Event

#11101: Deprecate "exclusive" events option from trigger method (Was this ever documented? Safe to ignore?) #11718: Deprecate .data() events #11719: Deprecate .bind("ready") event #11731: Deprecate "hover" pseudo-event #11733: Deprecate .load(), .unload(), and .error() methods #11786: Deprecate .toggle( handler, handler, … ) signature

Manipulation

#11231: Append, Prepend, After, Before should accept an array as first argument #11617: Define a $.parseHTML method for creating HTML fragments

Offset

#10996: Simplify offset() #11823: Remove webkitConvertPointFromNodeToPage

Selector

#9400: Deprecate :text, :radio, :checkbox, etc. selector extensions #11959: Add support for :active selector

Support

#9385: Deprecate jQuery.browser #11721: deprecate and remove internal uses of jQuery.support.boxModel #11766: Move jQuery.support to "unstable" status (?)

Traversing

#9800: New method: .addBack (supersedes .andSelf) #11738: Remove .closest(Array) returning Array

[mikesherov]

Only other thing worth noting is that the blog release notes weren't the full story. We retroactively went into trac and updated milestone on bugs we missed, so that's a better canonical reference.

[mikesherov]

http://bugs.jquery.com/milestone/1.8

[kswedberg]

Closing this. Continuing work in jquery/api.jquery.com