4 ms·
I'm sad that the on-site docs are still inferior compared to the in-code comment docs. For example, the on-site docs hardly mention the built-in state manager,
by mcrittenden 14y ago
I'm sad that the on-site docs are still inferior compared to the in-code comment docs. For example, the on-site docs hardly mention the built-in state manager, but they're very thoroughly documented in the code [1]. Many people (myself included) people will usually resort to searching Google before looking in the code when trying to figure out how to do something.
Ember team, any insight as to what's being done to rectify this, or why this is?
[1] https://github.com/emberjs/ember.js/blob/master/packages/ember-states/lib/state_manager.js#L5 https://github.com/emberjs/ember.js/blob/master/packages/emb...
- trek 14y agoAnything doc'ed in code is also available on the documentation subdomain: http://docs.emberjs.com/#doc=Ember.StateManager&src=false http://docs.emberjs.com/#doc=Ember.StateManager&src=fals...
- Osiris 14y agoThe documentation also completely ignores a number of objects and properties available in the framework which means that you either have to scan the source code or read through questions on www.stackoverflow.com with the [emberjs] tag. It can be quite frustrating while you're still learning the framework.