Okay, will do. Any feedback on the other comments? I'll proceed with merging the cordova-client and command line tooling spec next. I suppose it probably makes sense for me to start working out of JIRA so these tasks can be tracked. Is registration open or do I need to get permission from an admin for an account?
On Fri, Sep 7, 2012 at 2:37 PM, Filip Maj <f...@adobe.com> wrote: > 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 > >> >>> >> >> >> > >> >>> >> >> >> > >> >>> >> >> > >> >>> >> >> > >> >>> >> > >> >>> >> > >> >>> > >> >>> > >> > >> > >
