Need Documentation on Ember.StateManager / Ember.State

[patr1ck]

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.

[wagenet]

👍

[inkredabull]

Not that you can't find this simply by searching, but worth mentioning as a reference:
http://codebrief.com/2012/02/anatomy-of-a-complex-ember-js-app-part-i-states-and-routes/

[trek]

Could we at the very least do some poorly written, not-fully-documented, writing on the topic here? Controlling a single page section with a state manger makes sense to me but I'm not entirely clearly on what the intended usage is of things like multiple state managers or nested states (or possible even nested managers).

E.g.: a entering into a child viewState of a viewState will result in two sibling elements in the DOM. I see a test for it but I can't tell if that's the intended use (what would the use case be?) or just a side effect of me doing something unintended. My own expectation there would be for the child state to append a child view to the parent state's view.

Anywho, if someone threw together a sample of managing multiple page sections with a state manager with light commets, I'd be happy to write class documentation and a section for the emberjs site.

[wagenet]

There's some in the wild now and more coming.