jQuery is pure enjoyment: you try something and it works.
But the jQuery API documentation needs improvements on interface and content.
This problem affects both the description of a function and the alphabetical grouping of all the functions. So each function description is actually hidden inside two drawers, one for the tab of the first letter of the function name, and the other for the function itself. A bit more complicated than it should be for browsing an API documentation.
Visual jQuery is a replacement of the official interface and content. It’s based on the drawer metaphore as well, but with a twist. The user, knowing what is looking for, imagines a path of predefined categories, and opens all of their drawers to get there. It’s less weird than it seems from this description, but there is some additional problem.
I’ve just made yet another replacement of the jQuery API documentation.
It’s still far from completion. This is a partial list of what must be done.
- add alphabetical positioning for the links on the left; should be something similar to the original alphabetical tabs, just not tabs: clicking on a letter would cause the left pane to scroll
- make the functionality the main concept of the documentation and separate functionalities from functions, each in its own filing card: for example, “$( expr )” has now two different functionalities, so they should be represented by two separate filing cards;
- add a unique and persistent ID number to each functionality, so that they can be referenced from inside the documentation, and in the wild by means of a an URL ending with this ID; it would appear where now is a #
- check the description of any argument; should be very focused about what the function expects, how it’s related to the functionality
- add keywords to highlight documentation wide aspects; it would appear where now is the category; should be a comma separated list, with a fixed precedence
- check the description, and edit it thinking about the functionality, being very specific on what gets changed and what is returned
- find better and useful examples, always involving a DOM context that can be expressed by HTML markup, both in the Before and After sections.
- add a comment to a solution, relating it to “synonyms and antonyms”-like solutions
- developed at 1024×768 screen resolution using IE6: check others
- template adapted to CSS from one generated by Microsoft Word: refine