cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Steven Gill <stevengil...@gmail.com>
Subject Re: Docs versioning scheme
Date Sat, 30 Jan 2016 02:35:39 GMT
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" <csantana23@gmail.com> wrote:

> +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