cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Steven Gill <stevengil...@gmail.com>
Subject Re: Upgrading Guides
Date Wed, 17 Jul 2013 02:04:10 GMT
I have pushed the first draft of coreplugininstall.md to docs under the
plugins folder for now. I am not sure what the best directory to have it
under is and I need to make sure that some of the links in it work. Would
love someone to look over it (Mike Sierra maybe?)


On Tue, Jul 16, 2013 at 5:35 PM, Brian LeRoux <b@brian.io> wrote:

> Yar
> On Jul 16, 2013 5:23 PM, "Andrew Grieve" <agrieve@chromium.org> wrote:
>
> > SGTM as well.
> >
> >
> > On Tue, Jul 16, 2013 at 8:02 PM, Filip Maj <fil@adobe.com> wrote:
> >
> > > SGTM!
> > >
> > > On 7/16/13 4:59 PM, "Shazron" <shazron@gmail.com> wrote:
> > >
> > > >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.
> > > >> > >>
> > > >> >
> > > >>
> > >
> > >
> >
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message