Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cordova.apache.org
Received-SPF: pass (athena.apache.org: domain of shazron@gmail.com designates
 209.85.128.43 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CABiQX1UB4z9dze7jRKk629EkOCbSkQXA+WPi2FnDQdtHGNMbwg@mail.gmail.com>
References: 
 <CAJOjTCj7+hqWM_cq44=HKBiU-vsOPp06OHqQzffSHbYZq8NiXg@mail.gmail.com>
 <CE0A39A0.2276E%fil@adobe.com>
 <CABiQX1VkmhSeHvNeNFZwoKM3H4juYyagEHn+qJubfLyhXfM1Hw@mail.gmail.com>
 <CAOBL_k4Tf8NxmdjLHAEfAum6tfOG=7OD-kEjWrNqwb2kkxLk5w@mail.gmail.com>
 <CANpVHHxYLFd2A257VCsss4d6E2byz6Zr4zxYqDD-+rSM5jTw8g@mail.gmail.com>
 <CAOBL_k51UsuLC4noMmH-ewVhD7T5SPmgYDdiWs1k9LdL8-mr+Q@mail.gmail.com>
 <CABiQX1UB4z9dze7jRKk629EkOCbSkQXA+WPi2FnDQdtHGNMbwg@mail.gmail.com>
From: Shazron <shazron@gmail.com>
Date: Tue, 16 Jul 2013 16:59:36 -0700
Message-ID: 
 <CAE6O_-aR3mRt_iP6OTGBPVuA0ZRJHzASTpdHnJ7v6E+_LC4bWA@mail.gmail.com>
Subject: Re: Upgrading Guides
To: "dev@cordova.apache.org" <dev@cordova.apache.org>
Content-Type: multipart/alternative; boundary=047d7beb99fa56f96204e1a9c729

--047d7beb99fa56f96204e1a9c729
Content-Type: text/plain; charset=ISO-8859-1

For https://issues.apache.org/jira/browse/CB-4222

I added this note at the bottom of the 2.9.0 -> 3.0.0 Upgrading Guide for
iOS:

NOTE: Starting with Cordova 3.0.0, projects do not come with any plugins,
you will have to install the ones you require for your project using the
`plugman` CLI utility - see the Core Plugin Install Guide.

Note the currently non-existent "Core Plugin Install Guide" which is common
for all platforms. I talked to Steve, this doc should show two methods -
the Cordova CLI way and the plugman way of how to install the core plugins.
Since the Upgrading Guides are for legacy methods, it refers to the plugman
way.

Mike Sierra, not sure if this is a good method or we should cram everything
into the CLI doc.


On Tue, Jul 16, 2013 at 2:14 PM, Andrew Grieve <agrieve@chromium.org> wrote:

> +1 document both, but we should be clear that CLI is the new fancy and will
> eventually become the only supported (whatever that means) workflow at some
> point in the future.
>
>
> On Tue, Jul 16, 2013 at 5:00 PM, Joe Bowser <bowserj@gmail.com> wrote:
>
> > On Tue, Jul 16, 2013 at 1:41 PM, Anis KADRI <anis.kadri@gmail.com>
> wrote:
> > > I think we should document both.
> >
> > But we've already done the CLI docs. :P
> >
> > >
> > >
> > > On Tue, Jul 16, 2013 at 11:48 AM, Joe Bowser <bowserj@gmail.com>
> wrote:
> > >
> > >> On Tue, Jul 16, 2013 at 6:21 AM, Andrew Grieve <agrieve@chromium.org>
> > >> wrote:
> > >> > The CLI guide reads quite well! Great work whoever put it together!
> :)
> > >> >
> > >> > Just occurred to me that for 3.0 -> 3.1, we can probably just write
> a
> > >> > single "CLI" upgrade guide instead of writing one for each platform
> > >> (might
> > >> > need caveats per-platform still).
> > >> >
> > >> > Should we document how to create plugman-only projects as well as
> CLI
> > >> > projects? If so, we'll need a good top-level explainer page that
> > explains
> > >> > the difference. If not, then I don't think we should mention it in
> our
> > >> > readme. I'm hoping that we can document only the CLI flow so that
> > there
> > >> > will be less diversity in project structures out there, and it will
> > let
> > >> us
> > >> > focus on doing one thing well.
> > >> >
> > >>
> > >> I think we should document plugman-only projects, because that's what
> > >> exists today.  It's much easier to start to use plugman for a project
> > >> than to use the CLI, especially if you've done your own modifications
> > >> to the Java code in your Cordova project, which a few people have
> > >> done.  I see nothing here that helps our existing users maintain their
> > >> codebases.  If this project teaches you anything, it should teach you
> > >> that just because you want people to use your project a certain way,
> > >> it doesn't mean that they will.
> > >>
> >
>

--047d7beb99fa56f96204e1a9c729--