1. #1
    Sencha - Community Support Team jay@moduscreate.com's Avatar
    Join Date
    Mar 2007
    Location
    Frederick MD, NYC, DC
    Posts
    16,337
    Vote Rating
    75
    jay@moduscreate.com is a name known to all jay@moduscreate.com is a name known to all jay@moduscreate.com is a name known to all jay@moduscreate.com is a name known to all jay@moduscreate.com is a name known to all jay@moduscreate.com is a name known to all

      1  

    Default Offline documentation :: What does the community think?

    Offline documentation :: What does the community think?


    I've used offline docs for Ext JS since 2006 (yui-ext), and feel that they are important to be available for users who are traveling, in a secure location or just want fast docs fed from their machine. Sencha Touch no longer comes with offline documentation and per the following thread, offline documentation will no longer be available: http://www.sencha.com/forum/showthre...1&goto=newpost

    What does the community think? Should this be a poll?
    -->

  2. #2
    Sencha - Community Support Team grgur's Avatar
    Join Date
    Aug 2007
    Location
    Split, Croatia
    Posts
    154
    Vote Rating
    24
    grgur has a spectacular aura about grgur has a spectacular aura about

      0  

    Thumbs up


    I can see Mitch here saying: "Why, can't use use jsduck and generate it youself?"

    But, yeah, I'm with you. If you can generate, you might as well pre-generate it. Trans-atlantic flights would be much more enjoyable with offline docs available.
    Grgur Grisogono
    Ext JS in Action SE co-author
    Exercising awesomeness at Modus Create - Official Sencha Partner

    Get in touch for Sencha Touch Training
    @ggrgur
    -->

  3. #3
    Sencha - Senior Forum Manager mitchellsimoens's Avatar
    Join Date
    Mar 2007
    Location
    Gainesville, FL
    Posts
    35,704
    Vote Rating
    751
    mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute

      0  

    Default


    I personally would agree that we need to have offline documentation so I wouldn't stop at just saying use jsduck It's just a means to get around this shift.

    I personally use vhosts and update them with each new release so when I want to view ST2 docs, I just go to http://st2/docs/ and I'm good which this broke without using jsduck. I don't have much of a leg to stand on when I can easily get around it and I work for Sencha

    I like threads like these where the community voices up. It's very important that we at Sencha here constructive feedback from the community.
    Mitchell Simoens @SenchaMitch
    Sencha Inc, Senior Forum Manager
    ________________
    Check out my GitHub, lots of nice things for Ext JS 4 and Sencha Touch 2
    https://github.com/mitchellsimoens

    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 services@sencha.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.
    -->

  4. #4
    Sencha User
    Join Date
    Feb 2013
    Posts
    2
    Vote Rating
    0
    jakerella is on a distinguished road

      0  

    Default I haven't needed to use them offline... yet.

    I haven't needed to use them offline... yet.


    I simply haven't had a need to use the docs offline, but I can easily see myself needing to at some point. That said, I wonder if the existing API documentation site could be altered to be available offline. You know, hit a button and the site issues a request (or multiple) to download all of the docs and store it in LocalStorage for use while offline?

    Just a thought... in any case, there should be documentation available, but if I can be generated, I don't know that I care too much (although I apparently need to get jsduck in order to be ready to do that when I need to).
    -->

  5. #5
    Sencha User peterdehaan's Avatar
    Join Date
    Feb 2012
    Location
    Sunnyvale, CA
    Posts
    3
    Vote Rating
    0
    peterdehaan is on a distinguished road

      0  

    Default


    @Jay,

    What about if we provided a separate, standalone ZIP with all the docs for the product/version?


    @jakerella,

    The only downside of a LocalStorage type approach would possibly be that docs can sometimes be somewhat large. Looking at a local copy of the Sencha Touch 2.1.0 b1 SDK on my HD, it looks like the /docs/ folder is about 94.6MB and the /examples/ folder is another 47.4MB. That'd be a lot of data to try and push into somebody's local storage.

    -peter
    -----
    Peter deHaan (Sencha)
    -->

  6. #6
    Sencha User
    Join Date
    Feb 2013
    Posts
    2
    Vote Rating
    0
    jakerella is on a distinguished road

      0  

    Default


    @Peter Yeah, not so good.

    Other than shipping the generation tool along with the SDK, I don't see how Sencha can eliminate the offline docs. If it's a matter of space, maybe you eliminate the guides and keep the rest? Or like I said, ship the tool to generate the docs with instructions on how to do so.
    -->

  7. #7
    Ext GWT Premium Member
    Join Date
    Apr 2009
    Location
    NYC
    Posts
    111
    Vote Rating
    1
    stan229 is on a distinguished road

      0  

    Default


    Generally I use the online variant (docs.sencha.com/touch/) However, there comes a point where I'm on a train or somewhere without connectivity and have an epiphany when I realize I have offline docs available on my local httpd.

    While it is nice that it already comes bundled, I wouldn't mind a separate doc zip too much either. Might even be cleaner that way.
    -->

  8. #8
    Sencha - Senior Forum Manager mitchellsimoens's Avatar
    Join Date
    Mar 2007
    Location
    Gainesville, FL
    Posts
    35,704
    Vote Rating
    751
    mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute mitchellsimoens has a reputation beyond repute

      1  

    Default


    I'm not sure why we don't ship the docs locally like we always have. I know we made the move so that we can keep the online docs updated for any bugs and such but knowing that the online docs are always up to date and the docs shipped with that release is the docs at that point in time is ok IMO.
    Mitchell Simoens @SenchaMitch
    Sencha Inc, Senior Forum Manager
    ________________
    Check out my GitHub, lots of nice things for Ext JS 4 and Sencha Touch 2
    https://github.com/mitchellsimoens

    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 services@sencha.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.
    -->

  9. #9
    Sencha Premium Member bricemason's Avatar
    Join Date
    Jan 2008
    Location
    Upstate NY
    Posts
    280
    Vote Rating
    42
    bricemason has a spectacular aura about bricemason has a spectacular aura about bricemason has a spectacular aura about

      0  

    Default


    I don't see why they can't ship locally. We'll know where to go for the most up to date information.

    I would like to see the doc browsing experience improved on my tablet though. Using the docs on both my iPad and Nexus 10 is slow and painful. At least it doesn't seem to crash anymore but I'd like to see this get better.

    Thanks for listening,

    Brice
    Brice Mason
    Front End Developer
    Modus Create

    @bricemason
    bricemason.com

    Sencha Touch Screencasts
    Vimeo - Sencha Touch Channel

    Github Projects:
    Sencha Cordova Builder enables the automatic creation, building, and running of PhoneGap (Cordova) projects with Sencha Touch.

    Am I Sencha Touch Ready? checks your system to determine what you need to do to start Sencha Touch development. If you're having trouble getting up and running, try this out.

    Sencha Tools Bridge allows Sencha SDK Tools to co-exist with Sencha Cmd on the same system.
    -->

  10. #10
    Sencha Premium Member
    Join Date
    Feb 2012
    Location
    Berne, Switzerland
    Posts
    698
    Vote Rating
    40
    ingo.hefti has a spectacular aura about ingo.hefti has a spectacular aura about ingo.hefti has a spectacular aura about

      0  

    Default


    Quote Originally Posted by mitchellsimoens View Post
    I'm not sure why we don't ship the docs locally like we always have. I know we made the move so that we can keep the online docs updated for any bugs and such but knowing that the online docs are always up to date and the docs shipped with that release is the docs at that point in time is ok IMO.
    fully agree!
    -->

film izle

hd film izle

film sitesi

takipci kazanma sitesi

takipci kazanma sitesi

güzel olan herşey

takipci alma sitesi

komik eğlenceli videolar