cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Carlos Santana <csantan...@gmail.com>
Subject Re: Docs versioning scheme
Date Sat, 30 Jan 2016 02:08:30 GMT
+1

On Fri, Jan 29, 2016 at 8:47 PM Nikhil Khandelwal <nikhilkh@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:purplecabbage@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 <stevengill97@gmail.com>
> wrote:
>
> > +1
> >
> > On Thu, Jan 21, 2016 at 1:38 PM, Nikhil Khandelwal
> > <nikhilkh@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
> > >
> > >
> >
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message