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

mitchellsimoens

Quote:

Originally Posted by andyjv

Has there ever been a discussion on creating a Wiki for Sencha API?

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.

Quote:

Originally Posted by andyjv

Couldn't be any worse than the currently outdated and inaccurate docs.

Wouldn't say this is true but my own personal opinion.

23 Oct 2012, 11:26 AM

andyjv

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

andyjv

Every day I come across something like this, which is why there really needs to be a wiki:

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.