Hm.
If you look --> in the documentation <-- you find your first protest invalid. And in those docs you will find plenty of sample code, for your second protest, and examples (#3) to go with them (what is sample code if not an example?). #4 Protest too much? #5 Does a framework's theme need a template, too, or will a motif do?
And other pages that are just enumerations of things that are in the code, then you've just defined it, you haven't told me how to use it or why it works the way it does.
Instead, they'd need docs that lead the user through step-by-step breakdowns of where things are, why they are there, how to exactly build an app from nothing, and get it working. They've got none of that. Just a .zip with some crap in it and nothing that says what to do.
Then, your idea of "sample code" is a couple of blocks of js on an HTML page? Right, I need HTML, Js, server setups, everything needed to get it working. If I don't have that then you've skipped over a ton of shared knowledge I don't have and that you need to take out of your brain and lay down so I can follow along.
"Protest too much?" You're a dick. Seriously, I love you guys who come in talking all tough like you're so damn right and really you just pedantically split hairs then throw out ad hominem attacks while claiming you abhor them.
But, then again, like I give a fuck what you think. The people who will actually benefit from my comment will read it, and the guys like you will just go about your day writing down 5 paragraphs for your docs and wondering why people can't use your crap.
Comments
Hm. If you look --> in the documentation <-- you find your first protest invalid. And in those docs you will find plenty of sample code, for your second protest, and examples (#3) to go with them (what is sample code if not an example?). #4 Protest too much? #5 Does a framework's theme need a template, too, or will a motif do?
I looked at the --> documentation <-- and when you have a single page of "yo download, it's awesome" and then a page like this:
http://www.kendoui.com/documentation/javascript-dependencies...
And other pages that are just enumerations of things that are in the code, then you've just defined it, you haven't told me how to use it or why it works the way it does.
Instead, they'd need docs that lead the user through step-by-step breakdowns of where things are, why they are there, how to exactly build an app from nothing, and get it working. They've got none of that. Just a .zip with some crap in it and nothing that says what to do.
Then, your idea of "sample code" is a couple of blocks of js on an HTML page? Right, I need HTML, Js, server setups, everything needed to get it working. If I don't have that then you've skipped over a ton of shared knowledge I don't have and that you need to take out of your brain and lay down so I can follow along.
"Protest too much?" You're a dick. Seriously, I love you guys who come in talking all tough like you're so damn right and really you just pedantically split hairs then throw out ad hominem attacks while claiming you abhor them.
But, then again, like I give a fuck what you think. The people who will actually benefit from my comment will read it, and the guys like you will just go about your day writing down 5 paragraphs for your docs and wondering why people can't use your crap.
you want free software with great documentation, and you want it to amuse you too. anyone can ask for that stuff, far fewer are prepared to help out
I don't think he 'wants' anything from the project. He's just offering the developer some advice on how to gain traction.