Sorry for being late to the party. When I was a consumer of Phonegap back in the days, my most precious doc was the upgrade guides [1]. We didn't have the bandwidth or test process to update our app with every release of phonegap. But when it was time to upgrade (i.e. 1.4 to 1.9) The upgrade guide was my only resource to go over every change release by release, and I was happy after a week getting my app updated.
I think having the same for the Plugins will be of benefit to the consumers. In order of priorities: *1. Having a upgrade guide per plugin including api changes* 2. If we can, try to adopt semver and change the version according to the level of change As we document the breaking changes, we will feel the pain of consumers, and as we write a lot of doc for upgrading we will want not to doc and leave the api stable. [1]: http://cordova.apache.org/docs/en/3.4.0/guide_platforms_android_upgrading.md.html#Upgrading%20Android http://cordova.apache.org/docs/en/3.4.0/guide_platforms_ios_upgrading.md.html#Upgrading%20iOS On Wed, Apr 30, 2014 at 9:36 AM, Michal Mocny <mmo...@chromium.org> wrote: > Thanks for choosing a saner option than the wiki ;) > > > On Wed, Apr 30, 2014 at 12:34 PM, Ray Camden <rayca...@adobe.com> wrote: > > > Ok folks, here is the document. I even took a quick stab at an outline. > > I've set this as Anyone Can Edit, but if that causes problems I'll set it > > back to invited folks only. > > > > > > > https://docs.google.com/document/d/1uJ5qXqQxK2oh1eZPgMdYuhK2rQTB7QMHXUHbkcomWgk/edit?usp=sharing > > > > > > ________________________________________ > > From: Ray Camden <rayca...@adobe.com> > > Sent: Wednesday, April 30, 2014 11:28 AM > > To: dev@cordova.apache.org > > Subject: RE: Some pain points from our users :'( > > > > On it. > > ________________________________________ > > From: Steven Gill <stevengil...@gmail.com> > > Sent: Wednesday, April 30, 2014 11:12 AM > > To: dev@cordova.apache.org > > Subject: RE: Some pain points from our users :'( > > > > I would suggest creating a Google doc and sharing it here. > > On Apr 30, 2014 8:59 AM, "Ray Camden" <rayca...@adobe.com> wrote: > > > > > Crap, I spoke too soon. it is a "Immutable Page" and I can't edit it. > > > > > > ________________________________________ > > > From: Marcel Kinard <cmarc...@gmail.com> > > > Sent: Wednesday, April 30, 2014 10:41 AM > > > To: dev@cordova.apache.org > > > Subject: Re: Some pain points from our users :'( > > > > > > How about here? https://wiki.apache.org/cordova/signposts-draft . I'd > > > hope this works, as long as the contributions are considered "trivial" > by > > > Apache standards. Otherwise pull requests to cordova-doc.git would be > the > > > [slower and more proper] way to go. > > > > > > On Apr 30, 2014, at 11:29 AM, Ray Camden <rayca...@adobe.com> wrote: > > > > > > > Any particular place? Sorry if obvious - but it would need to be a > > > github repo multiple folks can edit. (Seems like that would be quicker > > than > > > PRs imo.) > > > > > > -- Carlos Santana <csantan...@gmail.com>
