Not a fan of this redesign.<p>-What happened to the comments? That was one of the most useful features of the old documentation, and I constantly relied on them to find examples or clarify edge cases.<p>-The code samples are on opposite colored backgrounds, which makes the whole page extremely painful to read. Can you imagine reading paper book that had code samples written in white text on a black background? How is that a good idea on the web?<p>-The huge blue border around the edge adds even more visual noise.<p>-Why is so much stuff laid out inside of boxes, starting with the list of functions? Developers are experts at reading raw blocks of text, so minimal formatting is needed.<p>-Finally, where did the old documentation go? The content has been changed, but where can we find it? There doesn't seem to be any links.<p>The old documentation definitely needed some work, but these improvements have brought with them new problems, and overall I find it harder to use than before.<p>Edit:<p>Compare Google's documentation: <a href="https://developers.google.com/maps/documentation/javascript/tutorial" rel="nofollow">https://developers.google.com/maps/documentation/javascript/...</a><p>While not perfect, it does a lot of things right: no extraneous formatting around the page edges, solid background, clean code examples, and importantly, access to old versions of the documentation.
FYI, I am working on a revamp of jQAPI, a alternative browser for the documentation. Should be released pretty soon.<p><a href="http://pre.jqapi.com/" rel="nofollow">http://pre.jqapi.com/</a>
<a href="https://github.com/jqapi/jqapi" rel="nofollow">https://github.com/jqapi/jqapi</a>
I would have liked it the jQuery API documentation would be closer to the PHP.net documentation. For instance, I want to know the options for $.post - going to <a href="http://api.jquery.com/post/" rel="nofollow">http://api.jquery.com/post/</a> would sure be nice (and even if it didn't exist, it could do a search for "you might have meant...")<p>For people unfamiliar with PHP.net's configuration, going to php.net/<function or whatever name> will go to the function if its known or search if it isn't (like <a href="http://php.net/strapos" rel="nofollow">http://php.net/strapos</a>)
I like the idea, but it's far more spread out than the previous design, and it's a bit much for me. I wish there was a google-like 'cosy' setting allowing me to compress things back a bit.
<i>Every</i> redesign on the web boils down to having less information on the viewport, requiring more scrolling, thanks to bigger font and wasted "Comfortable" spaces. It drives me crazy.<p>At least Google offers you a "Condensed" layout.
Nice update! Much appreciated improvements.<p>The only thing I noticed that was weird is the search box seems to have different behavior between the instant results and the results you receive when you hit <enter>. Not sure if this is intended, but the instant results seem to be limited to whatever categorical scope you're in.
This is still slow as shit, why? It seems to be running under php when the whole thing could've been generated with jekyll and maybe even pjax'd to make navigation even quicker.
I might not be in the majority here, but I like the redesign. Some of the entries might not be as complete, but I'm glad the comments section is gone because lets face it rarely was there anything useful in the comments, this isn't php.net.
Overall, this is a great update for the jQuery docs! It feels much more clean, and is a lot easier to navigate. My only complaint would be the dark code blocks, does it bother anyone else's eyes?
If you ask me, making the old one faster would have been much better; I don't go there for the nice design, I go because I have stuff to get done, and I'd rather get that stuff done fast.
I don't know if I am alone, but having no global view of methods in a category without scrolling down is a noticeable loss of productivity for me. I, too, would prefer a "cosy" setting of some sort.<p>When people start to make cheatsheets then it means your documentation lacks some bird's eye view...
This is a nice looking redesign but I think I'll probably stick to jqapi.com for quick reference. It's fast, I can find methods by URL (eg. jqapi.com/#p=get), and search auto-completes.
It looks nice, but the previous design was excellent. It had more examples, more detailed explanations, and lots of comments. I'll just have to get use to this.