Ember documentation TODO

gistfile1.md

Documentation

TODO

• API docs

• How to bootstrap a project

• Application structure (M/V/C layers and what they're for)

• Getting started with Ember and Rails

• Built-in controls

• How events are handled and bubbled

• Ember.ArrayController

• Array observers, propagation and ArrayProxy

• How the view layer works - 30,000 foot view

• How to use state managers

• Bindings and run loop overview

  • Run once

• Building Ember.js applications (conceptually, what needs to happen?)

• Debugging

  • Ember.Application and toString
  • {{debugger}}
  • {{log}}

• Handlebars composition

• Handlebars helpers

  • paths
  • binding aware

• View layer lifecycle hooks

• Others

  • Routing
  • Persistence
    • jQuery.ajax
    • Equivalent of Backbone sync
    • ember-data
  • ember-debug

I'd really like for the authors to consider being as rails-agnostic as possible. It just muddies the waters for people trying to use ember with .net or just straight up web services. You can write web services in rails and you can use ember with web services. One shouldn't have to do much with the other (unless there are some specific hooks that make rails work like magic with ember).

Here is the biggest thing to me. I didn't 'get' asp back in the day. One day I read an article about the 'page life cycle' that made everything gell. All of a sudden I was building server controls and it all made sense.

I'd love a 'page lifecycle' for ember. Or rather the event loop. A set happens. Code Runs. A collection of bindings is cross referenced. Observers run. Loop starts over.

@dgeb totally. i've actually rewritten your example in coffeescript locally, will likely share at some point. want to level up my own knowledge before disseminating the codes :-)

@skilesare maybe i'm not following, but Ember does have a loop. Are you looking for a different kind or didn't realize it?

@jackdempsey I just want someone to document it. Maybe with some pictures. See this: http://msdn.microsoft.com/en-us/library/ms178472.aspx I'll be more than happy to do it once I really understand it but I'm not there yet.

Hi guys! Yesterday, i wrote a post about how to contribute to Ember docs :)

When dealing with state managers and/or Rails, it would be helpful if best practices for authenticating a user against the back end server were explained. Perhaps an example where unauthenticated users are presented with only a login form and once authenticated, the rest of the interface appears with their name in the corner and the option to log out.

Hi there, what I would find really useful is a list of available plugins.
For instance, I have recently discovered this: http://ghempton.github.com/ember-layout-example/ which I think is really interesting.

@johngouf there are some useful links in the Ember.js wiki