23 Oct 2012 10:22 AM #1
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.
23 Oct 2012 10:30 AM #2
- Join Date
- Mar 2007
- Gainesville, FL
- Vote Rating
Mitchell Simoens @LikelyMitch
Sencha Inc, Senior Software Engineer
Check out my GitHub, lots of nice things for Ext JS 4 and Sencha Touch 2
Think my support is good? Get more personalized support via a support subscription. https://www.sencha.com/store/
Need more help with your app? Hire Sencha Services email@example.com
Want to learn Sencha Touch 2? Check out Sencha Touch in Action that is in print!
When posting code, please use BBCode's CODE tags.
23 Oct 2012 11:26 AM #3
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.)
24 Oct 2012 10:21 AM #4
11 Dec 2012 7:25 AM #5
12 Dec 2012 12:33 AM #6
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...