incubator-callback-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Brian LeRoux...@brian.io>
Subject Re: plugin tooling/specification
Date Mon, 03 Sep 2012 20:49:08 GMT
love it

On Sat, Sep 1, 2012 at 7:13 AM, Mike Reinstein <reinstein.mike@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 <fil@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.mike@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 <fil@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.mike@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 <fil@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.mike@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 <fil@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.mike@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
>> >> >> >>
>> >> >> >>
>> >> >>
>> >> >>
>> >>
>> >>
>>
>>

Mime
View raw message