Return-Path: X-Original-To: apmail-cordova-dev-archive@www.apache.org Delivered-To: apmail-cordova-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id CE20E104C2 for ; Mon, 21 Oct 2013 15:26:08 +0000 (UTC) Received: (qmail 25939 invoked by uid 500); 21 Oct 2013 15:26:08 -0000 Delivered-To: apmail-cordova-dev-archive@cordova.apache.org Received: (qmail 25911 invoked by uid 500); 21 Oct 2013 15:26:08 -0000 Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list dev@cordova.apache.org Received: (qmail 25903 invoked by uid 99); 21 Oct 2013 15:26:07 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 21 Oct 2013 15:26:07 +0000 X-ASF-Spam-Status: No, hits=2.5 required=5.0 tests=FREEMAIL_REPLY,HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of mike.billau@gmail.com designates 209.85.215.50 as permitted sender) Received: from [209.85.215.50] (HELO mail-la0-f50.google.com) (209.85.215.50) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 21 Oct 2013 15:26:03 +0000 Received: by mail-la0-f50.google.com with SMTP id ec20so2198024lab.23 for ; Mon, 21 Oct 2013 08:25:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=a9p0TwSkYj9NIGco19jf6D7n7Y9oAWbOg3eROF/vLwk=; b=kIsfk4RVkP95WvwYjh2geWX09gR5LhOjy3o3njAgqAt4PTMt9oOYv4vqgEMF1GFMWL /7L87sAEDT7FD/q5o1TwF+epr6QbCKR1oz226X2boVjkGQAe6a2WyBP+tkRQLSvGNwfU oJYa4oU3reYuyEp0G/ApSXiEksC9D+yGBuUB1CsbPVA35zgU6UQvAyp8YTzakTpl0g1d /JV05NSr7xIaj6YHE2xTUd0iev9Sx6sGhbxXwmlk5feq7/FvaECtQhPCyuXOSN8fgv42 DCn7FD1uZrOnxjX+tPF1lxb/IXKwXQM1WvVslq5+DnuUD38JRH52FlXyyN8DjjVlmbro YJjw== MIME-Version: 1.0 X-Received: by 10.112.210.197 with SMTP id mw5mr1633448lbc.42.1382369141690; Mon, 21 Oct 2013 08:25:41 -0700 (PDT) Received: by 10.112.132.8 with HTTP; Mon, 21 Oct 2013 08:25:41 -0700 (PDT) In-Reply-To: References: <1F75B71F-21D3-4998-A488-E85209ECB157@sap.com> <3C2399F1-DACC-462E-87F8-89FF55CF7BBB@pulse-robotics.com> <845affbc987030aeb660ff0c10656d5d@services.senegate.at> <6abfc174dffe4e418838c6e8e6337a1c@DBXPR03MB159.eurprd03.prod.outlook.com> <2619C1CC-7677-4183-B479-330E3D449B85@redhat.com> <5261fce9.63b6440a.1a95.3dee@mx.google.com> Date: Mon, 21 Oct 2013 11:25:41 -0400 Message-ID: Subject: Re: config.xml discussion, we need to talk From: Mike Billau To: "dev@cordova.apache.org" Content-Type: multipart/alternative; boundary=001a11c3c7dca3964a04e941e594 X-Virus-Checked: Checked by ClamAV on apache.org --001a11c3c7dca3964a04e941e594 Content-Type: text/plain; charset=ISO-8859-1 Lets make the name as confusing as possible, to live up to our history (callback, phonegap, cordova.) ;) Personally I think that the names should try to describe the difference between the workflows instead of trying to prescribe some type of usage, since there are unknown and developing use cases. To me the main difference between the workflows is that with the CLI, things get merged for you automatically, so I'm in favor of something like "CLI/Merges Workflow" and "Non-CLI/Legacy Workflow", and in the very first sentence of "Non-CLI/Legacy" we say "It's called "Legacy" because it was the pre-3.0 worfklow, not because it is no longer supported." Michal, we created an item to track the doc changes: https://issues.apache.org/jira/browse/CB-5122 I think the bulk of the workflow discussion can fit into the "Development Paths" section in the main Overview Guide. I'll get started but will continue to monitor this thread. On Mon, Oct 21, 2013 at 10:01 AM, Michal Mocny wrote: > (Okay, this thread at high risk of bikeshedding, just going to mention that > ;) But I do think it would be great to settle once and for all. > > I like the distinction Steven/Brian are making: Project flow vs Platform > flow. I'm not sure that those names are immediately 100% clear (I'll > ponder over it) but I like the focus points. > > I think Ian nails the description: "CLI encourages the "Your cordova web > view *IS* your application" mindset" > > I don't have a big preference one way or the other regarding attaching the > word "legacy" to the Platform Flow. I like that it conveys: "the flow you > are used to" and "there exists a new flow now that you should evaluate" but > I don't like that it may also convey "this flow is going to be deprecated" > which I don't think is true. > > Whatever we call it, I think its important to signal that Platform workflow > is for supporting "mucking with platform internals" not for "single > platform dev". Single platform dev can be done using CLI just as easily. > > Should we create a wiki/doc which explains the flow and lists the > pros/cons? > > > On Mon, Oct 21, 2013 at 9:20 AM, Ian Clelland > wrote: > > > Legacy, though, sounds like it's something that we're actively moving > away > > from; something that we support only grudgingly, and which we might > > deprecate at the drop of a hat. > > The platform-only workflow supports legitimate use-cases which CLI > probably > > will never cover -- things like embedding a cordova web view inside of a > > larger platform-native project. > > > > The major difference I see with CLI is that it encourages the "Your > cordova > > web view *IS* your application" mindset. (And if that's true, then why > > wouldn't you aim for cross-platform development?) The pre-CLI workflow is > > still the way to build all other sorts of applications. > > > > Ian > > > > > > On Fri, Oct 18, 2013 at 11:30 PM, purplecabbage > >wrote: > > > > > I like merge-flow and legacy-flow > > > > > > Sent from my iPhone > > > > > > > On Oct 18, 2013, at 6:59 PM, Carlos Santana > > > wrote: > > > > > > > > Cross Platform -> use Merge Flow > > > > > > > > Single Platform -> use Legacy Flow > > > > > > > > Using "Multi Platform or Cross Platform" is also fine > > > > > > > > Using "Flow or Mode" is also fine > > > > > > > > > > > >> On Friday, October 18, 2013, Brian LeRoux wrote: > > > >> > > > >> Ya, to me the difference is that one workflow embraces the native > > > platform > > > >> and tooling (plugman and bin/scripts) while the other focuses on > > > building a > > > >> web project (cli/merges/etc). > > > >> > > > >> As a dev, if I'm ONLY worried about one platform (like a Cordova > > > >> implementor or many of our community folk) then bin/scripts > suffices. > > As > > > >> soon as I'm concerned with more than one platform the CLI workflows > > kick > > > >> in. That was the use case anyhow. > > > >> > > > >> > > > >> On Fri, Oct 18, 2013 at 3:21 PM, Steven Gill < > stevengill97@gmail.com> > > > >> wrote: > > > >> > > > >>> Brian suggested Project Development (CLI workflow) vs Platform > > > >> Development > > > >>> (bin/scripts) > > > >>> > > > >>> > > > >>> On Fri, Oct 18, 2013 at 3:09 PM, Steven Gill < > stevengill97@gmail.com > > > > > > >>> wrote: > > > >>> > > > >>>> We need more suggestions! > > > >>>> > > > >>>> Anis suggested picking to arbitrary names that don't reflect the > > > >>> workflows > > > >>>> but would be easy to refer to. > > > >>>> > > > >>>> > > > >>>> > > > >>>> > > > >>>> On Fri, Oct 18, 2013 at 12:41 PM, Michal Mocny < > mmocny@chromium.org > > > >>>> wrote: > > > >>>> > > > >>>>> I use the IDE with the CLI and hope to make it better. > > > >>>>> > > > >>>>> In my mind, the old way is for making platform modifications, and > > the > > > >>> new > > > >>>>> way threads platforms/ as a build artifact. > > > >>>>> > > > >>>>> If you must control the platform code, you sacrifice easy > upgrades > > > and > > > >>>>> ease > > > >>>>> of multi-platform development, but gain control. > > > >>>>> If you want to use the CLI, you lose the ability to make > > > modifications > > > >>> to > > > >>>>> directly platform code without worrying about the implications. > > > >>>>> > > > >>>>> -Michal > > > >>>>> > > > >>>>> > > > >>>>> On Fri, Oct 18, 2013 at 3:18 PM, Steven Gill < > > stevengill97@gmail.com > > > > > > > >>>>> wrote: > > > >>>>> > > > >>>>>> I like that better. > > > >>>>>> > > > >>>>>> I know that both methods use the command line, but the > cordova-cli > > > >> has > > > >>>>> cli > > > >>>>>> in its name! We call the tool the cordova-cli so it might be > more > > > >>>>> confusing > > > >>>>>> going away from that and calling it anything else. Not saying we > > > >>>>> shouldn't > > > >>>>>> be open to a name change though just because we called it X > since > > > >> its > > > >>>>>> inception (or am I saying that? :P). > > > >>>>>> > > > >>>>>> When we write the docs about the other workflow (bin/create, > > > >> plugman), > > > >>>>>> maybe making the IDE an integral part of it would make it make > > more > > > >>>>> sense > > > >>>>>> calling that workflow IDE. Just a thought. > > > >>>>>> > > > >>>>>> > > > >>>>>>> On Fri, Oct 18, 2013 at 12:09 PM, Jesse < > purplecabbage@gmail.com > > > > > > >>>>>> wrote: > > > >>>>>> > > > >>>>>>> IDE or cordova-cli ?? > > > >>>>>>> > > > >>>>>>> @purplecabbage > > > >>>>>>> risingj.com > > > >>>>>>> > > > >>>>>>> > > > >>>>>>> On Fri, Oct 18, 2013 at 12:02 PM, Steven Gill < > > > >>> stevengill97@gmail.com > > > >>>>>>>> wrote: > > > >>>>>>> > > > >>>>>>>> I think SinplePlatform vs MultiPlatform is misleading because > > > >> you > > > >>>>> can > > > >>>>>> use > > > >>>>>>>> the CLI to do single platform development. > > > >>>>>>>> > > > >>>>>>>> > > > >>>>>>>> On Fri, Oct 18, 2013 at 11:51 AM, Jesse < > > > >> purplecabbage@gmail.com> > > > >>>>>> wrote: > > > >>>>>>>> > > > >>>>>>>>> SinglePlatform vs MultiPlatform makes the most sense to me. > > > >>>>>>>>> > > > >>>>>>>>> SinglePlatform = Focus on a single platform, and use plugman > > > >> and > > > >>>>> the > > > >>>>>>>>> platform scripts directly. Useful when you only have that > > > >>>>> particular > > > >>>>>>>> device > > > >>>>>>>>> to test on, or only have access to that device's marketplace. > > > >>>>> Also > > > >>>>>>>> useful > > > >>>>>>>>> for platform developers who are focused primarily on the > > > >> native > > > >>>>> code. > > > >>>>>>>>> ( aka DivideAndConquer ) > > > > > > > > > > > > > > > > -- > > > > Carlos Santana > > > > > > > > > > --001a11c3c7dca3964a04e941e594--