+1 On Fri, Jan 29, 2016 at 8:47 PM Nikhil Khandelwal <nikhi...@microsoft.com> 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:purplecabb...@gmail.com] > Sent: Thursday, January 21, 2016 2:50 PM > To: dev@cordova.apache.org > 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 <stevengil...@gmail.com> > wrote: > > > +1 > > > > On Thu, Jan 21, 2016 at 1:38 PM, Nikhil Khandelwal > > <nikhi...@microsoft.com > > > > > 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 > > > > > > > > >