Whither ScriptDoc?
Whither ScriptDoc?
I've searched the main, docs, and dev GGroups, but I haven't been able
to find a thread on this: if there was one but I just missed it, then
please direct me there.
I was just trying to find the line of reasoning behind removing the
ScriptDoc-esque comments from the jQuery codebase. Having the wiki
docs are super when approaching the library as a user, but the wiki
becomes less efficient for me when trying to navigate the internal
code workings.
Obviously, I can read the code to figure out what's happening, but
that is not as fast as having the comment "hints" at the top,
particularly given the terse naming scheme for method arguments. That
is not a complaint about terse variable names, by the way, just an
additional barrier to entry when trying to grok the code.
1.1.4 had 'em, so...why go to the effort to get rid of 'em?
Cheers,
Pyro