+1 ! (I THINK) eventually we will move pluginstall into apache (assuming the authors are cool with that) so it will go 2 docs -> 1 doc.
On 9/3/12 1:49 PM, "Brian LeRoux" <b...@brian.io> wrote: >love it > >On Sat, Sep 1, 2012 at 7:13 AM, Mike Reinstein <reinstein.m...@gmail.com> >wrote: >> Ah ok, thanks for the clarification. I've had a chance to review the >>docs >> more carefully. I'm really impressed with how well written they are. >>What I >> *think* makes the most sense is to consolidate into fewer documents so >>that >> it's not necessary to look at so many seperate places. Here's what I >> propose: >> * merge the cordova-plugin-spec into the alunny/pluginstall README.md >> * merge the command line tooling design doc into the cordova-client >> README.md >> * pull apart the cordova/PluginDesign wiki page and merge parts of it >>into >> the above 2 docs >> >> I think what this gets us is 2 docs instead of 5, and it still maintains >> the nice loose coupling between alunny's pluginstall utility and the >>larger >> cordova-client. I'm assuming this separation was the original intent, >> rather than having one monolithic tool. >> >> Would love feedback on this, I don't want to waste time doing it and >>find >> out this isn't appropriate. :) >> >> >> On Fri, Aug 31, 2012 at 3:35 PM, Filip Maj <f...@adobe.com> wrote: >> >>> Cordova-client depends on pluginstall. Pluginstall does the hard work >>>for >>> programmatic plugin installation, which is just one of the apis >>>available >>> in cordova-client. So, cordova=client "shells out" to pluginstall. >>> >>> The client also handles app creation, platform removal/addition, and >>> interpolating information from app's config.xml into the necessary >>>spots >>> in each native project. >>> >>> On 8/31/12 12:32 PM, "Mike Reinstein" <reinstein.m...@gmail.com> wrote: >>> >>> >Hey Filip, >>> > >>> >One thing I"m curious about, whats the difference between >>> >https://github.com/alunny/pluginstall and >>> >https://github.com/apache/incubator-cordova-labs/tree/cordova-client >>> > >>> >there seems to be some overlap there. Is pluginstall a subset of >>> >functionality just related to plugins that has moved into >>>cordova-client >>> >or >>> >is it different? >>> > >>> >It seems like cordova-client is the most mature codebase that >>>incorporates >>> >a lot of ideas, so I'm just chasing down code I'm finding to see if >>> >everythign is in cordova-client or not. Said differently, is it safe >>>to >>> >assume that just about all the worthwhile code is in cordova-client? >>> > >>> >-Mike >>> > >>> > >>> > >>> >On Fri, Aug 31, 2012 at 3:01 PM, Filip Maj <f...@adobe.com> wrote: >>> > >>> >> All looks good to me Mike. >>> >> >>> >> I think the "PluginDesign" wiki article would be a great place to >>> >> summarize / revamp all this info. Appreciate you tackling this! >>> >> >>> >> On 8/31/12 11:59 AM, "Mike Reinstein" <reinstein.m...@gmail.com> >>>wrote: >>> >> >>> >> >Hey Filip, Brian: >>> >> > >>> >> >I think where I'd like to start is on documentation. I may be wrong >>> >>about >>> >> >this, but it seems like there are bits and pieces of docs in >>>various >>> >> >places, and some may be stale or irrelevant. Maybe a good start is >>>for >>> >>me >>> >> >to find all these pieces, consolidate into a "master" document, and >>> >>cull >>> >> >out the outdated bits? As a start, here's my rephrasing of the >>>various >>> >> >links, etc that you've sent to me. Please take a look and let me >>>know >>> >>if >>> >> >I've characterised the content/purpose of these various links: >>> >> > >>> >> > >>> >> >*The spec for how plugins are declared is here: >>> >> >https://github.com/alunny/cordova-plugin-spec >>> >> > >>> >> >The implementation that manages plugin usage is here: >>> >> >>>>https://github.com/apache/incubator-cordova-labs/tree/cordova-client >>> >> >This project encompasses more than just plugins because it also >>>handles >>> >> >everything related to building, deploying, and managing cordova >>> >> >applications >>> >> > >>> >> >These plugins are most popular, and should ideally work with the >>> >> >cordova-client implemenation: >>> >> >http://github.com/phonegap/phonegap-plugins* >>> >> >* >>> >> >* >>> >> >This implementation by Drew was an initial proof of concept, which >>>only >>> >> >works for blackberry and has been abandoned in favor of >>>cordova-client, >>> >> >with much of his ideas having made it into cordova-client: >>> >> >https://github.com/deedubbu/cordova-blackberry-pluggable >>> >> > >>> >> >This doc contains some info on the format of the command line >>>interface >>> >> >and >>> >> >directory structure of cordova-client: >>> >> >http://wiki.apache.org/cordova/CommandLineToolingDesign >>> >> > >>> >> >This doc contains some documentation on Drew's old implementation, >>>and >>> >>is >>> >> >out of date now: >>> >> >http://wiki.apache.org/cordova/PluginDesign >>> >> > >>> >> > >>> >> >I want to emphasize that I'm just trying to get a handle on what >>>docs >>> >>are >>> >> >relevant and which links contain what. I'm not judging anyone's >>>work or >>> >> >anything like that. :) If I've got the wrong idea about what these >>> >>links >>> >> >represent or contain, _please_ let me know. >>> >> > >>> >> >-Mike >>> >> > >>> >> >* >>> >> >* >>> >> >* >>> >> >* >>> >> >* >>> >> >* >>> >> > >>> >> > >>> >> > >>> >> > >>> >> > >>> >> >On Sat, Aug 25, 2012 at 7:12 PM, Filip Maj <f...@adobe.com> wrote: >>> >> > >>> >> >> The cordova client CLI tooling top-level project goes >>>hand-in-hand >>> >>with >>> >> >> this spec. Code here: >>> >> >> >>> >> >> >>> >> >>> >> >>> >>>https://git-wip-us.apache.org/repos/asf?p=incubator-cordova-labs.git;a=s >>>h >>> >> >>or >>> >> >> tlog;h=refs/heads/cordova-client >>> >> >> >>> >> >> Essentially: vet the spec out to make sure popular plugins out >>>in the >>> >> >>wild >>> >> >> (see github.com/phonegap/phonegap-plugins) work with this spec. >>>Do >>> we >>> >> >>need >>> >> >> to account for anything else? >>> >> >> >>> >> >> I think the one outstanding question is how to handle >>>installation / >>> >> >> compatibility with different versions of cordova. >>> >> >> >>> >> >> Documentation for the tool as well as the spec (put it on the >>>wiki, >>> >> >> perhaps) would be awesome! >>> >> >> >>> >> >> On 8/25/12 10:23 AM, "Mike Reinstein" <reinstein.m...@gmail.com> >>> >>wrote: >>> >> >> >>> >> >> >Hi Brian, Filip, >>> >> >> > >>> >> >> >Thanks for the pointers to those projects. I'd love to dig in >>>and >>> >>start >>> >> >> >helping, where do you feel the most help is needed at the >>>moment? >>> >> >> >Documentation? Any specific code tasks? >>> >> >> > >>> >> >> >-Mike >>> >> >> > >>> >> >> > >>> >> >> > >>> >> >> >On Sat, Aug 25, 2012 at 12:51 PM, Filip Maj <f...@adobe.com> >>>wrote: >>> >> >> > >>> >> >> >> Also, this is the current de-facto plugin "spec" we are >>>working >>> >> >>towards: >>> >> >> >> https://github.com/alunny/cordova-plugin-spec >>> >> >> >> >>> >> >> >> On 8/6/12 8:20 PM, "Brian LeRoux" <b...@brian.io> wrote: >>> >> >> >> >>> >> >> >> >Hi Mike, you've come to the right place! Currently the plugin >>> >> >>tooling >>> >> >> >> >is being implemented by Anis, Fil, Michael, and myself. >>>(sorry >>> >>for >>> >> >>the >>> >> >> >> >delayed response / many of us are on a summer break after >>> >>shipping >>> >> >> >> >2.0) >>> >> >> >> > >>> >> >> >> >We're loosely collaborating using this list, git, and these >>>wiki >>> >> >>pages: >>> >> >> >> > >>> >> >> >> >- http://wiki.apache.org/cordova/PluginDesign >>> >> >> >> >- http://wiki.apache.org/cordova/CommandLineToolingDesign >>> >> >> >> > >>> >> >> >> >The dev is taking place a Cordova/Labs branch which you can >>> >>preview >>> >> >>on >>> >> >> >> >the Github mirror here: >>> >> >> >> > >>> >> >> >> > >>> >> https://github.com/apache/incubator-cordova-labs/tree/cordova-client >>> >> >> >> > >>> >> >> >> >You will want to start by reading up on our contrib process >>>in >>> >>the >>> >> >> >>wiki: >>> >> >> >> > >>> >> >> >> >http://wiki.apache.org/cordova/ContributerWorkflow >>> >> >> >> > >>> >> >> >> >And in the case of labs projects everything stays on its own >>> >>branch >>> >> >> >> >until such a time that we feel its solid for its own repo. >>> >> >> >> > >>> >> >> >> >* * * >>> >> >> >> > >>> >> >> >> >Let me know any q's! >>> >> >> >> > >>> >> >> >> > >>> >> >> >> > >>> >> >> >> >On Mon, Jul 30, 2012 at 4:18 PM, Mike Reinstein >>> >> >> >> ><reinstein.m...@gmail.com> wrote: >>> >> >> >> >> Hey there, >>> >> >> >> >> >>> >> >> >> >> I'm interested in contributing to the plugin system that is >>> >> >> >> >>forthcoming. Is >>> >> >> >> >> this the right place to bring it up? Who are the right >>>people >>> >>to >>> >> >>talk >>> >> >> >> >>to? >>> >> >> >> >> Where do you need the most help? I'm an experienced >>>developer, >>> >> >>have >>> >> >> >> >>worked >>> >> >> >> >> on a few phonegap based projects, and would love to give >>>back >>> >>to >>> >> >>the >>> >> >> >> >> community. >>> >> >> >> >> >>> >> >> >> >> cheers, >>> >> >> >> >> >>> >> >> >> >> -Mike >>> >> >> >> >>> >> >> >> >>> >> >> >>> >> >> >>> >> >>> >> >>> >>>
