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" <agri...@chromium.org> wrote: > > > SGTM as well. > > > > > > On Tue, Jul 16, 2013 at 8:02 PM, Filip Maj <f...@adobe.com> wrote: > > > > > SGTM! > > > > > > On 7/16/13 4:59 PM, "Shazron" <shaz...@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 <agri...@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 <bows...@gmail.com> > > wrote: > > > >> > > > >> > On Tue, Jul 16, 2013 at 1:41 PM, Anis KADRI <anis.ka...@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 <bows...@gmail.com > > > > > >> wrote: > > > >> > > > > > >> > >> On Tue, Jul 16, 2013 at 6:21 AM, Andrew Grieve > > > >><agri...@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. > > > >> > >> > > > >> > > > > >> > > > > > > > > >