Has there ever been a discussion on creating a Wiki for Sencha API? Couldn't be any worse than the currently outdated and inaccurate docs.
Has there ever been a discussion on creating a Wiki for Sencha API? Couldn't be any worse than the currently outdated and inaccurate docs.
The issue I see is that we then have to have someone approve and maintain quality control. You may do great at it but someone else may just provide not enough or plain wrong info. It's something that has been floated around so it's not being turned down just logistics that has to be figured out for building and maintaining.
Wouldn't say this is true but my own personal opinion.
Mitchell Simoens @LikelyMitch
Modus Create, Senior Frontend Engineer
________________
Need any sort of Ext JS help? Modus Create is here to help!
Check out my GitHub:
https://github.com/mitchellsimoens
Well you can update the docs with or without community help. Most of the common components already have plenty of comments that add to the documentation.)
Every day I come across something like this, which is why there really needs to be a wiki:
http://docs.sencha.com/touch/2-0/#!/...nePickerConfig
I'm surprised there isn't more intrest in a Wiki.
Really you can just look through http://docs.sencha.com/touch/2-0/#!/comment to see many cases of corrections and disappointment in the current docs.
As a general rule: duplication is the devil. Whenever you start duplicating information to multiple sources it is guaranteed to start and bite you in the ass at some point.
I have no experience (yet) with the Touch docs, but the ExtJS API docs are very well done in my opinion. Giving the extremely difficult context of the various browsers, the speed at wich both the web and Sencha are moving I find the docs astonishing good.
I believe your effort would be much better spent by providing suggestions to the docs. I have seen "bugreports" for the documentation being taken seriously and I have seen responses to inline comments leading to better documentation. In the end I believe it will be better if you comment in the docs, posts improvement suggestions on the forum or maybe even provide a patch every now and than that can be examind by a Sencha dude and merged into the source documentation.
Last edited by flanders; 12 Dec 2012 at 12:34 AM. Reason: it should be spent - I think...