Sorry for the late reply, this looks awesome! The one modification I would do is remove "www" as a platform (you have a comment in there about that too).
On 9/5/12 7:12 PM, "Mike Reinstein" <reinstein.m...@gmail.com> wrote: >> eventually we will move pluginstall into apache >Okay, I wasn't sure if that would happen, so I went with the slightly more >conservative assumption, that pluginstall might live separately from >cordova-client. But I get the impression this is a left-over notion from >when Andrew first built pluginstall and it wasn't clear then whether or >not >it would take hold. > >I've got an initial version of the merged documentation for the >pluginstall >command line tool, and the specification doc. It's here >https://github.com/mreinstein/pluginstall > >I've also added some comments on possible changes. Overall the doc is >pretty tight, so it's largely unchanged. Would really appreciate >constructive feedback on this. If it looks right I'll send a pull request >to alunny, and then proceed with merging cordova-client design doc into >the >README on github. > >-Mike > >On Tue, Sep 4, 2012 at 1:47 PM, Filip Maj <f...@adobe.com> wrote: > >> +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 >> >>> >> >> >> >> >>> >> >> >> >> >>> >> >> >> >>> >> >> >> >>> >> >> >>> >> >> >>> >> >>> >> >>
