From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932601AbbCIQfA (ORCPT ); Mon, 9 Mar 2015 12:35:00 -0400 Received: from mx1.redhat.com ([209.132.183.28]:35942 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754473AbbCIQe5 (ORCPT ); Mon, 9 Mar 2015 12:34:57 -0400 Date: Mon, 9 Mar 2015 11:34:50 -0500 From: Josh Poimboeuf To: Yaowei Bai Cc: corbet@lwn.net, trivial@kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] README: make the README agnostic to version numbers Message-ID: <20150309163450.GD10815@treble.redhat.com> References: <1425391683-3550-1-git-send-email-bywxiaobai@163.com> <20150306155938.GC8369@treble.redhat.com> <20150309153902.GA7742@bbox> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20150309153902.GA7742@bbox> User-Agent: Mutt/1.5.23.1-rc1 (2014-03-12) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Mar 09, 2015 at 11:39:02PM +0800, Yaowei Bai wrote: > On Fri, Mar 06, 2015 at 09:59:38AM -0600, Josh Poimboeuf wrote: > > On Tue, Mar 03, 2015 at 10:08:02PM +0800, Yaowei Bai wrote: > > > As we have moved to 4.x, it should be reflected in README. > > > > > > Signed-off-by: Yaowei Bai > > > --- > > > README | 34 +++++++++++++++++----------------- > > > 1 file changed, 17 insertions(+), 17 deletions(-) > > > > Remove all references to Linux version numbers (except for the examples) > > in the README so we won't have to update it again for Linux 5.0. > > It sounds great, but i think that would be more easily comprehensible with version > numbers in README, especially for the ones who are not familiar with Linux kernel > very much. Meanwhile, does it make sense for a software without version number > in release file? Personally I don't think the "4.x" numbers add anything to the understanding of the document. And anyway, Linus doesn't update them to 4.0, 4.1, etc per release, so it's not a real release file. > On the other hand, it only need *one* patch to update the version > numbers in README every several years, i.e. about 8 years and 4 years > for 3.x and 4.x, respectively. True, changing this file every 4 years or so isn't a big deal. But Linux doesn't do _big_ changes any more, so whether its "3.x", "4.x", or "x.y", the use cases and release notes are the same. -- Josh