1. #1
    Sencha User
    Join Date
    May 2010
    Posts
    53
    Vote Rating
    0
    dukeyboy is on a distinguished road

      0  

    Default Unless I'm missing something, the documentation is still most disappointing.

    Unless I'm missing something, the documentation is still most disappointing.


    The ext-js documentation appears to be the barest of bones documentation. To get anything done you have to trawl the Internet to try to glean information for various sources on how to do things.

    The reference guide *should* be providing an example with every single method or property but there seem to be almost no examples included at all. Not only should there be an example but there should be some narrative explanation of how things work.

    Consider for example this single case: I wish to know how to allow my end user to navigate a grid using keys, and I wish to allow them to make multiple selections of rows. Can anyone show me anywhere in the Sencha documentation that explains this in any meaningful way, except for the most terse of minimal statements that the exists a property that may or may not relate to what I am trying to achieve.

    I had thought Sencha was trying to turn over a new leaf and include useful documentation but we're getting closer to the release and I hate to say it but for beginners, the Sencha documentation is extremely unhelpful.

    Most disappointing. Makes the process of developing anything very time consuming and needlessly difficult.

  2. #2
    Ext JS Premium Member stevil's Avatar
    Join Date
    Nov 2007
    Location
    Denver, CO
    Posts
    1,045
    Vote Rating
    9
    stevil will become famous soon enough

      0  

    Default


    I'm a bit frustrated as well, but I'm writing most of that off to the fact that they're still refactoring the framework as we proceed through the beta cycles (may be better to let things settle down first).

    I'm not sure I need to see an example for every property, but I agree that more narrative, and maybe additional documents are necessary.

    I definitely think more documentation is required where *Cls properties are concerned. For example, I'd like to see a diagrammatic representation of the markup for each of the controls, indicating where each of the class properties is applied to that markup - don't make us iterate through the process of setting the properties, rendering, then inspecting the DOM to figure out where they do (or don't) apply.

    To me, this seems a more massive undertaking (for them and for us) than the 2 to 3 upgrade - while that was difficult, 3 to 4 has more fundamental framework changes and refactoring. I'll reserve judgement until I see the release doc.

    stevil

Similar Threads

  1. Some documentation missing
    By asadani in forum Sencha Touch 1.x: Discussion
    Replies: 0
    Last Post: 8 Sep 2010, 2:53 AM
  2. Missing texts in API documentation
    By strictlyphp in forum Ext 3.x: Help & Discussion
    Replies: 1
    Last Post: 3 Sep 2010, 5:56 AM
  3. [Ext JS 3.0 RC1] Missing information in documentation...
    By ritesh.kapse in forum Ext 3.x: Help & Discussion
    Replies: 3
    Last Post: 16 Apr 2009, 5:13 AM

Thread Participants: 1