Missing `jQuery` return type for several methods

[tjvantoll]

A whole lot of methods that return jQuery objects are not documented as such. Even common ones like open(), close(), and destroy().

We should probably update that. I think a lot of people don't realize that you can chain those calls.

[scottgonzalez]

Well, this is kind of tricky. The methods don't actually return anything. The widget factory generates a return value when the methods are called via the jQuery plugin method. So dialog.close() has no return value, but elem.dialog( "close" ) does.

[tjvantoll]

Well, this is kind of tricky. The methods don't actually return anything. The widget factory generates a return value when the methods are called via the jQuery plugin method. So dialog.close() has no return value, but elem.dialog( "close" ) does.

Ah ok, definitely tricky. Our docs (currently) only list methods available through the plugin, and the code examples only show the plugin syntax - so I would lean towards listing the return type of the plugin syntax, but I could go either way.

I'll bring this up at the meeting today to get some other opinions.

[tjvantoll]

Discussed in IRC.

The plan is to document such method's return types as "jQuery (plugin only)", where "plugin only" is a link to a learn article that describes the two means of invoking widget methods.

[tjvantoll]

Wrote a learn article. Pull request: jquery/learn.jquery.com#417

[tjvantoll]

@scottgonzalez I'm assuming you intended to tag grunt-jquery-content?

[scottgonzalez]

I did this on the plane and pushed when I got to the hotel. I'll get this deployed soon.