Of course, so when somebody -- a recruiter, for example, says, "what's
wrong with the jQuery library?", you can say:
- Poor selector engine
- Non-descriptive method names
- Hard to debug
- long, overloaded methods with too much abstraction
- Poorly degradable
- loosely defined constructs and vague documentation
- Low-quality plugins
- Silly (and futile) things in source, like `isPlainObject`
- Significant and numerous core upgrades that break functionality
- plugins don't work
- documentation doesn't reflect new behavior
(modified list of gripes from a colleague).
Amnesia flaring up again?
There's a tsunami of evidence and demonstration behind my statements
(as you well know). As I said, search the archive.
The OP asked for "links to very convincing articles". In your response,
I see cynical opinion and no links. That's not even a concise summary of
any one library. It sounds snide, actually. And no urls.
I've done all of the hard work. You yourself were just parroting some
of it recently.
That is untrue.
I've have never wanted to copy anything of yours.
It's been done to death (as you well know).
URL?
That ship has sailed and long since reached its destination.
If you are trying to say that an article was published then post a URL
so the OP can see it.
[...]
Yes. Again, done to death at this point. I mean, Prototype?! Could
there be a less relevant example at this juncture?
One point to be gleaned from that is what sort of change it can affect.
A subtler point is that the mistake I made was not emphasizing enough
about what to do instead. Look how many switched to jQuery.
The review also shows an example outline of how to do a review. It
starts at a very high level with technical *facts*.
| A code review should be objective and should state actual problems.
| Saying "the code is bad" is not a helpful review. Instead, explain
| the problem clearly. If the problem is severe, then say why.
<
http://jibbering.com/faq/notes/review/>
I've emphasized these points many times regarding your reviews and I've
noticed improvement, but I think it can still get better.
People will respect you if you follow that.
And even a Prototype core developer criticizing Prototype:
http://perfectionkills.com/whats-wrong-with-extending-the-dom/
Now more and more are flocking to jQuery. Great. Well, not really.
[...]
Okay. I think you are way late on that one as well.
Opinions are funny things. Everybody's got one.
My observations are that many developers are unaware of how selectors work.
I've notice that some foster beliefs that the jQuery "bare words"
proprietary selector syntax is designed to work match attributes instead
of properties. In contrast, the source code of jQuery indicates that it
was designed to select properties.
Further evidence indicates that there may be uncertainty as to whether
or not the jQuery author(s) know what it was designed to do or knew that
it was invalid CSS selector syntax. The documentation says it selects
attributes, the website says it is css3 compliant. Blog entries seem to
be vague and contradictory.
My observation is that developers are confused as to how selectors
really work.
Your hypothetical article pales in comparison to my somewhat legendary
output in this area. Best of luck with it!
Then post a link to what you feel are your best ones. Let them speak for
themselves and quit boasting about them.
Look:
<
http://www.google.com/search?q=jquery+"code+review">
I don't see any jQuery code reviews. Chances are, the OP doesn't either.
I've found:
http://www.doxdesk.com/#u20091116-jquery
- which is funny, but not a serious code review (the author is
knowledgeable and provides humorous insight. He seems to not take jQuery
seriously).
My opinion is that jQuery is taken seriously by so many that it cannot
be just laughed off and it cannot be just called garbage. In order to
effect a change, one must take it head on in a more formal code review.
Talk to the reader as if he's right in front of you; don't insult his
intelligence and don't assume he understands everything you do. Be
concise. Make it understandable at a high level to anyone. Try to see it
from the perspective of the user who llikes it. Try to see it from the
perspective of the author who wrote it and is now stuck with design
decisions -- what can he do? Are they fixable? If so, how? If not, why
not? Parsing selectors - sounds neat, right? Well, the problems with
that are...
[brief introduction]
[summary overview of problems]
[exposition and demonstration of each problem]
[elaboration on design issues]
[alternative]
[conclusion]
Writing something like that is not going to be easy; not something that
can be completed in under a week.
A link to such formal review of jQuery would be useful and valuable.
My prototypejs review was painful, not because I had to go and find
problems, but because I had to communicate them effectively to readers
who liked Prototype.js.
Garrett