lkml.org 
[lkml]   [2019]   [Feb]   [24]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH] Documentation/process/howto: Update for 4.x -> 5.x versioning
On Sun, Feb 24, 2019 at 11:16:56AM +0100, Federico Vaga wrote:
> hello,
>
> I have just a general observation for the community, not related to the
> content of this patch, but related with the idea behind.
>
> Is it really important to specify the major release number in the documents? .
> Can't we just use a generic x.y.z, or a more generic statement?
>
> When you open a documentation page like
>
> https://www.kernel.org/doc/html/latest/
>
> you will see the release number in the top left corner, which implies that
> what you read is (should be) valid for that version. And if you read from the
> sources you should know which version you checked out, and if you don't you
> can always verify.
>
> I do not see the added value of having those numbers in the documents, unless
> the purpose is to highlight some specific exceptions.
>
> Am I missing some important reasons that justify these numbers?

Nothing really, it's just "history". Given that the "major" number only
changes every 3-4 years, it's not all that big of a deal.

If you can think of a way to write these documents such that they do not
depend on a version number at all, I'm sure no one would object to those
patches.

thanks,

greg k-h

\
 
 \ /
  Last update: 2019-02-24 13:55    [W:0.046 / U:0.248 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site