cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Treggiari, Leo" <>
Subject RE: Independent platform release summary
Date Wed, 08 Oct 2014 20:39:13 GMT
> Did I miss anything?

I don't think we closed on this (I had to leave the meeting a little early) but a remaining
question is how to version what we (and users) call "Cordova".  Assuming a "Cordova" version
is a point in time collection of the latest CLI version + platform versions + plugin versions.
 Is the Cordova version semver (using what algorithm with respect to its contained components)
or is that what you meant by  ""latest as of Oct 2014" or something".  


-----Original Message-----
From: [] On Behalf Of Michal Mocny
Sent: Wednesday, October 08, 2014 1:13 PM
To: Michal Mocny
Cc: Marcel Kinard; dev
Subject: Re: Independent platform release summary

Thanks everyone for participation in what was a long and grueling

Summary of current proposal:
- Cad-ver is dead.
- Everything moves Sem-ver, with platforms continuing from current versions
and diverging over time.
- CLI potentially gets a significant version bump to showcase this reset
(to 5.0 or 10.0, not yet settled)
- Pinning default platform versions *will* continue for the time being, but
it will be trivial to override the default.
- Platforms will have CLI <engine> tag equivalent (unclear yet if as node
peerDependency or otherwise) so devs will know when they need to
upgrade/downgrade CLI for non-default platform versions.
- After a platform update, eventually CLI will release to "pin" the new
default, and bump its PATCH/MINOR version (unless CLI had a functional
update at same time that requires a larger bump).
- After you update CLI, your existing projects don't change & platform
upgrades remain explicit, but you will now get warnings if your installed
platforms are older than the CLI pinned versions.
- Event MAJOR changes to platforms are not MAJOR updates to the CLI, unless
there is an actual breaking change to the CLI tool (i.e. new CLI will no
longer work with the currently installed platform).
- Platform and CLI docs have to split out and be released & versioned
alongside each (like plugins).  Cross references from one to the other will
only be needed in a few places.

Note: The CLI-Platform compatibility story is functionally no different
than we have today.  If you upgrade your CLI and there is a breaking
change, you will have to re-create your projects or downgrade CLI again.
Now we plan to be more explicit about it and offer warnings.

Note: There is no concept of a "fancy-pants" release other than to say
"latest as of Oct 2014" or something.  Platforms don't have a single common
set of functionality, so CadVer was somewhat misleading already in that
sense.  We could introduce a concept of "API Level" for exec bridge or
something for use by plugins, but not sure that has value.

What wasn't covered that came to mind after the fact:
- When there is an update available for CLI, should we give a warning to
update? (this is useful, but isn't common for npm modules.  I think we
already do this from plugman when you try to publish plugins?).

Did I miss anything?


On Wed, Oct 8, 2014 at 12:35 PM, Michal Mocny <> wrote:

> External Public link for those that just want to watch/chat:
> Hangout link to join the conversation:
> See you in 30 minutes.
> On Wed, Oct 8, 2014 at 12:33 PM, Michal Mocny <> wrote:
>> +dev list again
>> Not everyone could make 1pm, not everyone could make 2pm.  While I don't
>> think we need a full 2 hours, I'm hoping to start late and end early --
>> proving opportunity people to pop in at either time and chime in.
>> On Wed, Oct 8, 2014 at 12:18 PM, Marcel Kinard <>
>> wrote:
>>> Is the expected duration 1 hour or 2 hours?
>>> On Oct 8, 2014, at 10:56 AM, Michal Mocny <> wrote:
>>> > So it looks like Today 1-3 EST or Friday 1-3 EST are the best times.
>>> I'm
>>> > going to start the ball rolling to do this TODAY, but if that proves
>>> too
>>> > short notices we'll move it to Friday.
>>> >
>>> > I'll email out links to hangout at 12:30 or so, and I'm hoping Steven
>>> can
>>> > make it before 2pm since he's been most active with releases recently.
>>> >
>>> > -Michal
View raw message