Live data from Hacker News

"Getting started with Ember.Js is easy." - No it isn't

discuss.emberjs.com

81–90 of 252 posts

Re: "Getting started with Ember.Js is easy." - No it isn't

#81
post #38

> The tone of this topic is not in line with the civil level of discourse I'd like to maintain here, so I cannot respond. This sounds like the euphemistic version of "I don't like your attitude, so fuck off." Not exactly the answer I would want to get as a new user who is stumbling over terrible and inconsistent documentation and error messages.

Yes, that immediately turns me off the project. This is great feedback and not at all rude, I wish I could get feedback like this for my projects!

Re: "Getting started with Ember.Js is easy." - No it isn't

#82
post #45

In my personal opinion, I'd like to present a fair comparison with another similar framework called KnockoutJS. I challenge anyone on Hackernews to show me better documentation than this one: http://learn.knockoutjs.com Notice how things are explained so well as if they were explained to a child, this is how you should document, IMO. Also, RP Neimeyer, the creator (EDIT: Committer) of this framework, has dedicated a…

KO has great how-tos and examples, no doubt, but I would never put it forward as an example of great documentation, for the single and very large fact that it's utterly lacking in API reference documentation. Where, for instance, can I find a list of the ko.utils.* namespace? How do I release bindings when I dispose of a view? The existing documentation gives me nothing. I'm left googling blogs and stackoverflow answers.

Compare that to http://docs.angularjs.org/api .

Real API documentation would do a lot to dispel the myth that KO is only for small to medium projects.

Re: "Getting started with Ember.Js is easy." - No it isn't

#83
What an obvious oversight. It is unbelievable that the developers would allow for a 'getting started' guide with such a poor first impression to exist. I have had a similar experience with jquery. As someone who has been using mootools before jquery I was completely furious with the lack of proper documentation and ambiguity in it. I hated learning jquery. Thank god mootools exists. Confusing, incomplete or ambiguous documentation is the absolute worst obstacle to a positive learning experience. I've not tried Ember, but if the experience is as the author describes, then I shall stick to angularjs. And what a tragic reaction to the criticism from the ember developer. It seems fitting that their documentation would be crappy. I'm sure that ember is a wonderful project and took a lot of hard work to create, but please fix the first experience - is important otherwise all that hard work goes to waste. Good luck.

Re: "Getting started with Ember.Js is easy." - No it isn't

#84
post #74

Moved to the correct thread per @kbenson's response

You responded in the wrong order. The important point is that Ember is trying to improve, and values the feedback, right?

Defending another team member that you didn't think represented himself well should be secondary. He's a grown man, and can defend himself if needed (especially from the fallout of his own words). Addressing this first just gives me the impression that Ember is focusing on, and learning the wrong lesson, from this problem.

Re: "Getting started with Ember.Js is easy." - No it isn't

#85
If the new user 'try this out' tutorial is busted, and the core team knows this. why is ember being pushed so hard?

recently there were many articles on HN itself about how great ember is. if it's so great, why is it people get frustrated with the most simple tutorial?

Why was the response 'i refuse to respond' instead of 'this is a known issue, we're working on it as fast as we can'?

Re: "Getting started with Ember.Js is easy." - No it isn't

#86
post #78

Trek is making a huge mistake IMHO. As a developer I can think of nothing more helpful than to get a "steam-of-consciousness" excerpt from our users. This is something no analytics package can tell you, if you want to make your "product" easy to use then this is the exact feedback you need. Delverworld was outlining the various pitfalls of getting started with ember.js and a core contributor shrugs it off because he…

I have admitted that, publicly, very often, in other topics on discuss.emberjs.com, on websites, on twitter, on videos, and elsewhere. It's no secret I'd like to improve the documentation for Ember.js and I'm already well aware of the places that people are facing difficulty right now. There's work, if people spent a moment reading the top topics in the forum, on a getting started guide with a direct call for feedbac…

That's actually a very decent answer. You should've expanded your reasoning a bit on the ember thread. Although to be honest, I thought the tone was more funny than sarcastic, but I'm emotionnally detached from the subject. With your explanations, your reaction makes sense. Sarcasm is a slippery slope.

Re: "Getting started with Ember.Js is easy." - No it isn't

#87
post #78

Trek is making a huge mistake IMHO. As a developer I can think of nothing more helpful than to get a "steam-of-consciousness" excerpt from our users. This is something no analytics package can tell you, if you want to make your "product" easy to use then this is the exact feedback you need. Delverworld was outlining the various pitfalls of getting started with ember.js and a core contributor shrugs it off because he…

I have admitted that, publicly, very often, in other topics on discuss.emberjs.com, on websites, on twitter, on videos, and elsewhere. It's no secret I'd like to improve the documentation for Ember.js and I'm already well aware of the places that people are facing difficulty right now. There's work, if people spent a moment reading the top topics in the forum, on a getting started guide with a direct call for feedbac…

I see what you're saying, and it is a fair attitude. The problem is that I think others disagree on your definition of civility; for example I am of the opinion that the post was perfectly civil, and I think others would tend to agree.

You are of course free to set your own standards in your own community, however I think it would serve you well to recognize that the implied standards you are setting are extremely, extremely high. In my opinion they are so high that they are counter productive, and I posit that the fact that this article is now at the top of hacker news suggests that many people agree with me on this point.

Re: "Getting started with Ember.Js is easy." - No it isn't

#88
post #69

Trek is making a huge mistake IMHO. As a developer I can think of nothing more helpful than to get a "steam-of-consciousness" excerpt from our users. This is something no analytics package can tell you, if you want to make your "product" easy to use then this is the exact feedback you need. Delverworld was outlining the various pitfalls of getting started with ember.js and a core contributor shrugs it off because he…

It's not the first time. I've been in their IRC. They are friendly and helpful. Especially Yehuda, but there seems to be this idea that if you "don't" get it, you might just be stupid... http://twitter.com/trek/status/302811479135092736 I got this tweet and I constantly look at it before deciding against giving Ember another try. So far I'v done Backbone, Angular and Batman and I've had no problems with either of the…

I came to a conclusion some years ago: if too many users are wrong, it's probably your fault. There's not some conspiracy by a bunch of unrelated users to all trip over the same things. It probably represents an actual problem. I learned this myself with a dumb little proxy instruction web page. http://rachelbythebay.com/w/2011/07/15/ui/

Re: "Getting started with Ember.Js is easy." - No it isn't

#90
post #84
post #74

Moved to the correct thread per @kbenson's response

You responded in the wrong order. The important point is that Ember is trying to improve, and values the feedback, right? Defending another team member that you didn't think represented himself well should be secondary. He's a grown man, and can defend himself if needed (especially from the fallout of his own words). Addressing this first just gives me the impression that Ember is focusing on, and learning the wrong…

You're right, this should have specifically been in response to the post that was expressing frustration with Trek.
Post reply on HN