Looking at the two guides right now, two things struck me as different: 1. Andrew's walks you through *how* to install all of the required tools, we just say which tools to install 2. Andrew's instructions go through the old way of setting up a project, which is now out of date. But! Once going through them, you get a pretty good idea of how Cordova works because he points out what all of the pieces do. E.g. the jar is the native side, the www is your code, the manifest is where your permissions go.
As for #1, I think the short version we have in our guide is sufficient, and I don't like the idea of having it explained out more thoroughly step-by-step, because it's then more of a pain to keep up-to-date. I can see us doing more in the area of #2 though. E.g. have a separate guide that goes through all of the parts of an Android Cordova app, and points out which ones you may want to touch at some point. I also agree that it might make things more clear to separate out IDE instructions from the core command-line instructions. I don't think we should remove them though, since the IDE is the harder thing to figure out usually :P. Perhaps to tie in these external tutorials, we add a note at the bottom saying that if you still need help, to search for external tutorials / youtube walkthroughs / link to the user forums? We could also mention which versions of Cordova have had changes in steps, so that they don't follow old tutorials like the one that was pointed out. On Sat, Jan 19, 2013 at 12:42 PM, Shazron <shaz...@gmail.com> wrote: > Just at a glance, I suppose his tutorial has more screenshots and steps. We > could take the good and extract the incorrect and fix those I suppose. > > As for command line, that is definitely where we are going and if we remove > Eclipse instructions (which third-party bloggers can fill the gap) we > should point them to the alternative instructions. Which brings me to the > next question -- should all platforms remove IDE specific instructions? > There are some things in iOS currently that we can't do command line (at > least with the current tools), for example deploy to device. > > > On Sat, Jan 19, 2013 at 9:11 AM, Joe Bowser <bows...@gmail.com> wrote: > > > Andrew Trice's tutorial is out of date and is technically wrong. The > > Android target for a project should always be set to the latest. I > > would agree with Don about not having Eclipse in our instructions, > > except that I don't have that much confidence in the command line > > tools on Windows to do that. > > > > I think the question that should be asked is why users find Trice's > > tutorial better? I don't think it has anything to do with the content, > > since the content is the same other than the part where you select > > your target manually in Eclipse. > > > > On Sat, Jan 19, 2013 at 8:40 AM, Don Coleman <don.cole...@gmail.com> > > wrote: > > > I think it's better to remove Eclipse from the instructions. > > > > > > Have users build and deploy with ./cordova/run. > > > > > > Suggest using a text editor like Sublime Text to edit assets/www. Note > > > that Eclipse or IntelliJ IDEA works if they'd prefer. Link to external > > > articles with more details. > > > > > > > > > > > > > > > On Sat, Jan 19, 2013 at 10:45 AM, Shazron <shaz...@gmail.com> wrote: > > > > > >> Some feedback from users: > > >> https://groups.google.com/d/topic/phonegap/K9uv3Hc-EfI/discussion > > >> > > >> Their feedback is, Andrew Trice's tutorial is way better than our > > official > > >> one: > > >> > > >> > > > http://www.adobe.com/devnet/html5/articles/getting-started-with-phonegap-in-eclipse-for-android.html > > >> > > >> What do you guys think? We can contact Andrew to maybe donate his > > content > > >> to Apache Cordova and we can update/adapt it. > > >> > > >
