Good point Ray. Another option would be to create a branch-per-component e.g. tools, android, ios, etc. that changes go into, and then merge into master from the branch that corresponds to the release that is happening
On Fri, Jul 11, 2014 at 2:02 PM, Michal Mocny <[email protected]> wrote: > Ray, but I thought we always wanted more cowbell? > > Sorry, had to. I agree with Ray here, but I would also want to see latest > fixes to docs that apply to released version. > > Suggestion: rely on discipline to markup documentation changes which only > apply to development versions? > > e.g. > > <div class="available-in-4.0"> > Now with more ---cowbell! > </div> > > And part of release instructions is to change styling from looking > scary/experimental to looking ordinary? > > -Michal > > > On Fri, Jul 11, 2014 at 1:51 PM, Ray Camden <[email protected]> wrote: > > > Ok, so let me rephrase then. Imagine the next version of the CLI adds > > cowbell support: > > > > cordova cowbell --epic > > > > but this is NOT in the release version. > > > > If I go to docs.cordova.io, click on The Command Line Interface, will I > > see cowbell documented? If so, I think that is a mistake. > > > > ________________________________________ > > From: [email protected] <[email protected]> on behalf of Andrew > Grieve < > > [email protected]> > > Sent: Friday, July 11, 2014 11:39 AM > > To: dev > > Subject: Re: Pointing docs to edge > > > > Yeah, plugin docs are already gone from docs.cordova.io. This change is > > strictly for guides & platform docs. The main motivation here is that it > > doesn't make sense to have versioned docs if platform versions diverge > > anyways. It actually already makes little sense for the tools guides, > since > > they are released more often the platforms. > > > > > > On Fri, Jul 11, 2014 at 12:36 PM, Max Woghiren <[email protected]> > wrote: > > > > > My understanding is that plugin docs live in plugin repos and will be > > > versioned alongside the plugins themselves. They'll be removed from > > > docs.cordova.io. > > > > > > > > > On Fri, Jul 11, 2014 at 11:49 AM, Ray Camden <[email protected]> > wrote: > > > > > > > Is edge what people use when they get the latest version of cordova > or > > a > > > > plugin? If not, I'd strongly argue against it. > > > > > > > > If I download the Camera plugin, I expect the default docs to match > > whats > > > > shipped in that version. > > > > > > > > ________________________________________ > > > > From: [email protected] <[email protected]> on behalf of Max Woghiren < > > > > [email protected]> > > > > Sent: Friday, July 11, 2014 10:46 AM > > > > To: dev > > > > Subject: Pointing docs to edge > > > > > > > > Just wanted to bring back this conversation—how does everyone feel > > about > > > > switching docs.cordova.io to point to edge? There has been some > > > > discussion > > > > about cutting versioned docs after 3.5.0, and we're approaching a > good > > > time > > > > to do it. :) > > > > > > > > > >
