top | item 3624210

JQAPI - Alternative jQuery Documentation

105 points| Garbage | 14 years ago |jqapi.com | reply

30 comments

order
[+] fatbat|14 years ago|reply
"Just to make it clear, I only coded the navigation and re-styled the documentation."

It is not clear if you are hosting the documentation or not. I ask because I have encountered problems accessing the official jq doc sometimes. Would be nice if this was an updated "mirror". And I definitely like the search better. ;)

[+] mustardamus|14 years ago|reply
Yes, it also functions as a mirror. Even the official @jquery Twitter account referred to it several times when the official docs were down.

Thanks!

[+] Xion|14 years ago|reply
Very nice work here! The search is definitely better than in original version, the docs itself are more tidily formatted and easier to read, and the whole website is just much more lightweight than the jquery.com version. I'm pretty certain I'll be using this when looking up jQuery docs now.

I have only one grudge so far: there seems to be no way of generating an URL to search query, as /#p=XXX only works if XXX is part of the API (e.g. jQuery.ajax) rather than arbitrary term (e.g. ajax). Were it corrected, it would be trivial to integrate JQAPI search into web browser, YubNub, shell, etc.

[+] mustardamus|14 years ago|reply
You're right. Search via URL is also on my to-do list.
[+] canton|14 years ago|reply
Love better docs! Amusing fail though: impossible to scroll home page on my android device. Must be some kind of JS hook on scrolling that's breaking drag support.
[+] yatsyk|14 years ago|reply
I like http://jqapi.ru because I can search everything with Ctrl/Command-F on one page.
[+] mustardamus|14 years ago|reply
I also planned to have a generated cheat sheet as a entry point for the new jQAPI.
[+] jablan|14 years ago|reply
Couple suggestions:

You should make the fact that this is downloadable and suitable for local/offline use more prominent.

I guess lots of people would benefit if you made the downloadable packages dynamic (e.g. "Zip me docs for jQuery vX.Y.Z and jQuery UI vY.Z.X"), similar to what railsapi does.

[+] mustardamus|14 years ago|reply
I planned filter functionality for the different versions of the docs. But I will not provide dynamic packages because I want jQAPI to be only client-side for easy mirroring.

An additional service would be possible thought.

[+] switz|14 years ago|reply
I've been really enjoying using http://dochub.io/ recently.
[+] bwarp|14 years ago|reply
Here I sit on an 8 core Xeon with 32Gb of RAM and Firefox and it's so slow that it's unusable...

I prefer clean, static documentation (like: http://docs.python.org/)

[+] ranza|14 years ago|reply
Its a bit heavy but very cool!
[+] rachelbythebay|14 years ago|reply
Something is very wrong with the scrolling of this page on iOS. It's like this page is missing the usual inertia which you will find nearly everywhere else.

Please, don't mess with the scrolling.

[+] mustardamus|14 years ago|reply
I didn't mess with the scrolling because I haven't planned to support iOS in the first place. Sooner or later that will be fixed.
[+] tlianza|14 years ago|reply
Before a trip I went on a month ago, I grabbed the downloadable html version. It was an absolute lifesaver, and made my plane rides 10x more productive.

Many thanks to those who put it together.

[+] kamjam|14 years ago|reply
That's a very good point, I haven't properly used jQuery since 1.4.2 and it would be good to catch up on the new features of the API during "dead time" like this.
[+] damiongrimfield|14 years ago|reply
any chance you could avoid using the XHR to load content for the downloadable version?

i get this error in chrome: XMLHttpRequest cannot load file://localhost/Users/damion/Downloads/jqapi-latest/navigation.html. Origin null is not allowed by Access-Control-Allow-Origin.

in the meantime i've been using chrome as my browser, and safari as my dedicated jqapi renderer.

[+] frederico|14 years ago|reply
Awesome; if you could add syntax highlighting I think this would be pretty dang perfect. Navigation is much easier.
[+] VonLipwig|14 years ago|reply
Looks good and very useful. Any chance you can stop the keyboard popping up on the iPad when you touch the menu?
[+] mustardamus|14 years ago|reply
I'd love to make it iPad compatible with the new version I am (slowly) working on. But there is a good chance I never will own a iPad ;) Have to see if I can co-work with somebody on that.