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=sh >> >> >>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 >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >>
