Yes. Sorry. I was just trying to get it out asap. I'll look into updating it on Sunday/Monday. On Jan 29, 2016 7:09 PM, "Carlos Santana" <[email protected]> wrote:
> +1 > > On Fri, Jan 29, 2016 at 8:47 PM Nikhil Khandelwal <[email protected]> > wrote: > > > Looks we did a release for the docs with the tools release. Is it > possible > > to name it 6.x instead of 6.0.0? All URLs to 6.0.0 will break if we do > that > > but we should do that sooner rather than later to minimize impact. > > > > As discussed, micro-versioning of docs does not buy us much. I'll enhance > > our cordova-docs readme and editorial guide for docs with details on how > we > > handle versioning. > > > > -Nikhil > > > > -----Original Message----- > > From: Jesse [mailto:[email protected]] > > Sent: Thursday, January 21, 2016 2:50 PM > > To: [email protected] > > Subject: Re: Docs versioning scheme > > > > SGTM! +1 > > > > > > @purplecabbage > > > > > https://na01.safelinks.protection.outlook.com/?url=risingj.com&data=01%7c01%7cnikhilkh%40microsoft.com%7c82dab60846b14dded12d08d322b54957%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=fiC5HqwZWlaOSZD4ipn97isk7hjFjVCht9IzgKZKnFA%3d > > > > On Thu, Jan 21, 2016 at 1:47 PM, Steven Gill <[email protected]> > > wrote: > > > > > +1 > > > > > > On Thu, Jan 21, 2016 at 1:38 PM, Nikhil Khandelwal > > > <[email protected] > > > > > > > wrote: > > > > > > > Should we version our docs on every major version (instead of minor > > > > version) of cordova CLI that comes out? Should the next version of > > > > the > > > docs > > > > be "6.x"? Honestly, not much changes every minor release and > > > > maintaining multiple copies has quite a few downsides w.r.t. SEO > > > > (referring to older versions of docs), slow docs builds, huge website > > duplication. > > > > > > > > Lot of our docs relate to platform updates and we need clear > > > > sections within them that specify the version of the platform for > > > > which the docs apply to. For example, Android 5.1 will introduce new > > > > lifetime concepts which will be part of Cordova 6.0 docs release. > > > > It's best for the text of the docs itself to have something along > > > > the lines of "This applies to cordova-android > 5.1" > > > > > > > > Similarly, significant future updates to CLI/Lib features can > > > > contain the same "This applies to cordova > 6.2". > > > > > > > > I think it will lead to a simpler model on our website and prevent > > > > future version explosion [1]. > > > > > > > > Thanks, > > > > Nikhil > > > > > > > > [1] > > > > https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fimgu > > > > r.com%2fvkeNvUL&data=01%7c01%7cnikhilkh%40microsoft.com%7c82dab60846 > > > > b14dded12d08d322b54957%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata= > > > > Yh%2b9h4MUN9VfUADA1unTmUExqioMs75xG1HjVYmDSBc%3d > > > > > > > > > > > > > >
