Zooming in on Chrome (Mac) causes "Back to Top" to be in the wrong spot

There have already been some questions about events which haven't been fired and the solution was the event-name-translation happening in event-dispatcher, see http://stackoverflow.com/questions/10213252/ember-view-contenteditable-events

This should be added to the website, in conjunction with the possibility to add events which are not yet handled by specifying a customEvents property when creating the Ember.Application.

See PSD comps for how it should be

There is no link on the left side that links to the GH repo or GH org. It would be very helpful to have this.

The main layout has a "typo" in the footer:

<a href="http://tilde.io">Tilde Inc.<a/></div>

Should be

<a href="http://tilde.io">Tilde Inc.</a></div>

https://github.com/emberjs/website/blob/master/source/layout.erb#L95

1.0 pre release notes indicate handlebars no longer bundled.

in 0.9.8 Ember.Button was deprecated but website does not mention it (and lists it as a 'normal' view)

...when you fill up the one before.

The example shown on the documentation page about setting child view templates is incorrect in versions > 0.9.8.1

Here's a JSFiddle for 0.9.8.1
The latest version of ember
A working example with the latest version of ember

The example template should be this:

<script type="text/x-handlebars" data-template-name="info">
  <b>Posts:</b> {{view.posts}}
  <br>
  <b>Hobbies:</b> {{view.hobbies}}
</script>

I would generate a pull request for the documentation change, but don't feel confident enough that I understand all of the terminology properly.

A duplicate of this bug exists here: emberjs/ember.js#988 (comment)

Must scale :D I've got the PSDs for ya.

In portrait orientation I find the text is too small for comfortable reading, but when zooming in the menu overlays the text making reading even more difficult.

Can you add a closing tag to the list?

<h1>People</h1>

<ul>
{{#each peopleController}}
  <li>Hello, <b>{{fullName}}</b>!</li>
{{/each}}
</ul>

Also the home page uses ember-data. Is that going to be officially integrated into ember? Otherwise can you change that so it looks more like...

App.Person = Ember.Object.extend({
  firstName: null,
  lastName: null,
  fullName: function() {
    return this.get('firstName') +
           " " + this.get('lastName');
  }.property('firstName', 'lastName')
});

App.peopleController = Em.ArrayController.create({
  content: [App.Person.create({firstName:"John", lastName: "Smith"})]
});

I just started looking at Ember this weekend and that example confused me for longer than I really care to admit. I'm guessing there is a transition going on, but until it does it would be great it the examples worked with the source out of the starter kit.

What is the license of the middleman helpers in config.rb?

Right now the forEach section suggests that you do:

var array = [1,2,3];

array.forEach(array.removeObject, array);

However, this is a poor example since the array will actually not be emptied completely. This isn't a bug, but it is confusing.

Hi,
I've decided yesterday that it was time for me to dive in Ember.js. To be honest, I was not sure where to start.

The starter kit is way too basic for what I needed. The examples? Yeah, maybe better, but I wanted to take a look at a some guide and doc before to have a high-level understanding of the principles you are building Ember on.

I've started to read the docs, then hopped into the guides. I think I should have done the opposite maybe. You are also talking of ember-data in a guide without having any explanation of what it is which could be confusing for someone that never heard anything from Ember before.

Doc and guides doesn't seem to be presented in a logical order (I might be totally wrong), or at least it is lacking some "hey, start here, and then read that" indications. Maybe switching "Docs" and "Guides" in the menu would be a first step and then maybe add a Getting Started guide (there is one in PR #137, but I don't know if it still relevant as things are still changing before 1.0, which is just fine).

In the Guide page, maybe adding some short description of each guide and it's level and/or prerequisites would be a great idea?

Those are ideas, and might not the be the best approach either.

Let me know what you think of how to help newbies to get up to speed as fast as possible and still explain all that needs to be understood.

Thanks for all your hard work!

Hi,

Font family chosen for the website makes it difficult to read. It would be great to change it.

BTW - Nice job with the new API website.

Thanks
Karl

It'd be great if the complete API docs at https://github.com/emberjs/ember.js/tree/master/docs were on the ember.js website itself. It's difficult for newcomers to learn the API without it there.

I came across this today: http://www.meetup.com/Ember-SF/events/50058382/

Perhaps there should be a section, under community, that contains links to Ember-related events.

Thoughts?

Update: I found a Meetup list on the ember.js wiki. I've added the above link there.

The bindAttr documentation in my browsers (Ubuntu/Chrome and OS X/Safari) doesn't display the attribute. I went to the website project and checked the markdown source code, and it correctly displays the attribute via GitHub. Therefore, it looks like the intent is correct, and there is nothing I can do in a pull request. For some unknown reason, the website just isn't showing the attribute.

For example, the code example is missing the src attribute:

<img {{bindAttr ="logoUrl"}} alt="Logo">

It should have been rendering as:

<img {{bindAttr src="logoUrl"}} alt="Logo">

This is repeated in the isDisabled example, as well as in the next section, "Binding Class Names with {{bindAttr}}".

They are generated such that they don't match.

I'm trying to follow along with the Ember Application Structure guide, which describes how to subclass Ember.Router, however it doesn't specify how and when App.Router is instantiated.

Instead, the guide should note how and when App.Router is instantiated; specifically indicating whether the developer should instantiate an instance of it or if Ember will instantiate one instead.

It looks like calling App.initialize(); causes App.Router to be instantiated. This should probably be documented in this guide, or a mention in this of another guide that explains that it should be called.

Refiled from emberjs/ember.js#1104

If two-way bindings are desired with user-modifiable fields, it is necessary to implement a view that listens for the appropriate event. For most common inputs, we supply built-in controls that handle this for you.

In the section "Binding Class Names with {{bindAttr}}" (http://emberjs.com/documentation/#toc_binding-class-names-with-bindattr) the bindAttr examples are incomplete, the attribute name is not present:

<div {{bindAttr ="priority"}}>
  Warning!
</div>

While the examples are correct in the source https://github.com/emberjs/website/blob/master/source/docs/handlebars.md :

<div {{bindAttr class="priority"}}>
  Warning!
</div>

Hey guys,

I'd suggest noting that using data-template-name, means the template is parsed and loaded in memory somewhere, but will have to be instantiated via javascript, and then appended to some element/view/container.

Peter

Hi,

It looks like you could use output_style :compressed for production mode, instead of default one.

http://emberjs.com/stylesheets/site.css
http://emberjs.com/stylesheets/highlight.css

Regards,
Paweł

The Ember Application Structure guide currently refers to subclassing Ember.State instead of Ember.Route, however according to #1009 it should be using Ember.Route instead.

Accidentally submitted previously to emberjs/ember.js#1105

There is an error in this documentation: http://docs.emberjs.com/#doc=Ember.Application&src=false
MyApp = Ember.Application.create({
rootElement: $('#my-app')
});
ought to be:
MyApp = Ember.Application.create({
rootElement: '#my-app'
});

I really like the flow of the rails-tutorial; I think it might be missing a couple of steps in getting the initial view to the homepage.

This section on loading the app is either missing some code, or I have done something wrong

  Photoblog.photosView = Ember.ContainerView.create({
    currentViewBinding: 'Photoblog.stateManager.currentState.view'
  });
  Photoblog.photosView.append();

If you can link me to the rails app repo that implements the guide, I'll help edit the tutorial... It could be beneficial to have a new ember dev go through the tutorial to see it work and test any rough spots.

cc/ @patr1ck @tomdale

There should be some mention in the Binding examples that they don't sync immediately.

I think either it should be mentioned or the examples should be updated.

MyApp.president = Ember.Object.create({
  name: "Barack Obama"
});

MyApp.country = Ember.Object.create({
  // Ending a property with 'Binding' tells Ember to
  // create a binding to the presidentName property.
  presidentNameBinding: 'MyApp.president.name'
});

MyApp.country.get('presidentName');
// undefined

See: emberjs/ember.js#423

Hi! A friend told me in the morning that he had problems
with the binding examples on the website, it would be
great if we can add some explanation to Ember.run.sync()

MyApp.president = Ember.Object.create({
  name: "Barack Obama"
});

MyApp.country = Ember.Object.create({
  // Ending a property with 'Binding' tells Ember to
  // create a binding to the presidentName property.
  presidentNameBinding: 'MyApp.president.name'
});

// This forces the bindings synchronization:
Ember.run.sync();

MyApp.country.get('presidentName');
// "Barack Obama"

hi,

is like the font used on the API section have not a good rendering,
on my screen "e" look like a "c".

http://tinypic.com/r/3523yp3/6

my configuration is:
winXP pro 32bit and opera 11.64.
same result observed with chrome 19.0.1084.46 m

safari 5, firefox 12 and IE8 looks good.

I think it would be pretty cool if my choice method visibility in API browser was remembered.

I've checked out the repos as stated in the Readme. I then executed bundle and bundle exec rakep but I get the following error:

/usr/local/Cellar/ruby/1.9.2-p290/lib/ruby/gems/1.9.1/bundler/gems/rake-pipeline-3088a028f567/lib/rake-pipeline/middleware.rb:1:in `require': no such file to load -- rack (LoadError)
    from /usr/local/Cellar/ruby/1.9.2-p290/lib/ruby/gems/1.9.1/bundler/gems/rake-pipeline-3088a028f567/lib/rake-pipeline/middleware.rb:1:in `<top (required)>'
    from /usr/local/Cellar/ruby/1.9.2-p290/lib/ruby/gems/1.9.1/bundler/gems/rake-pipeline-3088a028f567/bin/rakep:12:in `require'
    from /usr/local/Cellar/ruby/1.9.2-p290/lib/ruby/gems/1.9.1/bundler/gems/rake-pipeline-3088a028f567/bin/rakep:12:in `<top (required)>'
    from /usr/local/Cellar/ruby/1.9.2-p290/lib/ruby/gems/1.9.1/bin/rakep:19:in `load'
    from /usr/local/Cellar/ruby/1.9.2-p290/lib/ruby/gems/1.9.1/bin/rakep:19:in `<main>'

Anybody else ran into this?

In the HTML snippet it shows '{{#each controller}}'.

Shouldn't that be '{{#each APP.peopleController}}' or '{{#each APP.peopleController.content}} ?

After some amount of pain involved in getting an Ember.Router working, I think the approach here is wrong. Starting at the templates and working backward to the router is, uh, backward.

A more natural point of introducing the concept is the Ember.Router or URL de-structuring. Based on @wycats' gists, it seems like the focus should be on serialization of state (i.e. the Router). The templates and references to {{outlet}} come too early.

If readers were to be made to what the route was, and that some assumptions were made in terms of naming and view, and that based on those assumptions a given template file was going to be used, then I think the message of this document would come across more clearly.

This may just be my particular learning style, but i found myself acking the source a bit too often for this guide to merit a "done" status. Any complaints with my taking a stab at it from another direction?

Steven

The headers on http://docs.emberjs.com/ and http://emberjs.com/ are inconsistent.

Something ala http://ruby-doc.org/core-1.9.3/ for searching classes/methods/properties would greatly improve usability of API browser.

I'm getting the following error in my ember-website clone:

$ bundle exec rake preview
Generating docs data from /home/ubuntu/src/ember.js... error: --------------------------------------------------------------------------
error: An uncaught YUIDoc error has occurred, stack trace given below
error: --------------------------------------------------------------------------
error: 
TypeError: Cannot set property 'module' of undefined
    at [object Object].<anonymous> (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/lib/docparser.js:493:29)
    at [object Object].<anonymous> (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/lib/docparser.js:1251:40)
    at Array.forEach (native)
    at Function.<anonymous> (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/node_modules/yui/yui-nodejs/yui-nodejs.js:2397:20)
    at f (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/node_modules/yui/oop/oop-min.js:7:221)
    at [object Object].each (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/node_modules/yui/oop/oop-min.js:7:1206)
    at [object Object].processblock (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/lib/docparser.js:1223:15)
    at [object Object].<anonymous> (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/lib/docparser.js:1307:26)
    at Array.forEach (native)
    at Function.<anonymous> (/home/ubuntu/src/ember.js/docs/node_modules/yuidocjs/node_modules/yui/yui-nodejs/yui-nodejs.js:2397:20)
error: --------------------------------------------------------------------------
error: Node.js version: v0.6.12
error: YUI version: 3.6.0
error: YUIDoc version: 0.3.22
error: Please file all tickets here: http://github.com/yui/yuidoc/issues
error: --------------------------------------------------------------------------
rake aborted!
No such file or directory - /home/ubuntu/src/ember.js/docs/build/data.json

Tasks: TOP => preview
(See full trace by running task with --trace)

I'm honestly not sure what's causing it.

Hi,

Any interest in contribution to help you out for translation of the documentation in french?

Zooming in on Chrome (Mac) causes "Fork Us" to have an improper line break.

the bindAttr examples are not displaying correctly on the frontend documentation page (http://emberjs.com/documentation/)

under the header: "Binding Element Attributes with {{bindAttr}}"
2nd code block (and others)

when viewing in github it appears correctly:
https://github.com/emberjs/website/blob/master/source/docs/handlebars.md#binding-element-attributes-with-bindattr

and on the frontend the attribute name is missing
http://emberjs.com/documentation/#toc_binding-element-attributes-with-bindattr

Ember.Application is declared in ember-runtime/lib/system/application.js to be usable for runtime-only apps, but most app use the definition here: https://github.com/emberjs/ember.js/blob/83542a629c214f1a9e89dcf8b9388e48ae2ba4e8/packages/ember-application/lib/system/application.js#L187

The docs for the latter definition are great, and should be included, but only the docs from the runtime version of Application are being built at the moment.

It's unclear which version of Ember the Documentation and API apply to. I am assuming the current stable (1.0 pre as of writing this), but it would be good to know.

It may also be worth keeping the documentation for the older versions. Similar to Node.js documentation where the latest is always under the same URL but the older versions have a path like /v0.9.8.1/.

Right now there's a hole in the documentation with regards to Ember's StateManager. From what I've seen it's pretty useful, so it would be good to have docs for it.