public inbox for kernel-janitors@vger.kernel.org
 help / color / mirror / Atom feed
From: Oliver Neukum <oneukum@suse.com>
To: Jonathan Corbet <corbet@lwn.net>,
	Finn Thain <fthain@linux-m68k.org>,
	Bagas Sanjaya <bagasdotme@gmail.com>
Cc: Linux SCSI <linux-scsi@vger.kernel.org>,
	Linux Documentation <linux-doc@vger.kernel.org>,
	Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
	Linux Kernel Janitors <kernel-janitors@vger.kernel.org>,
	Ali Akcaagac <aliakc@web.de>, Jamie Lenehan <lenehan@twibble.org>,
	"James E.J. Bottomley" <jejb@linux.ibm.com>,
	"Martin K. Petersen" <martin.petersen@oracle.com>
Subject: Re: [PATCH 3/3] Documentation: scsi: dc395x: Remove reference to 2.4 driver
Date: Tue, 9 May 2023 10:55:46 +0200	[thread overview]
Message-ID: <8536273d-20a4-1993-1381-b50e44701835@suse.com> (raw)
In-Reply-To: <87pm7enbpo.fsf@meer.lwn.net>

On 05.05.23 15:34, Jonathan Corbet wrote:
> Finn Thain <fthain@linux-m68k.org> writes:
> 
>> On Fri, 5 May 2023, Bagas Sanjaya wrote:

>> Would it make a difference if someone does run that? Were you planning to
>> delete the source code for the 2.4 kernel too?
> 
> Most of the 2.4 code has indeed been deleted *from current kernels*.
> It's not clear to me why 2.4 documentation should be immune to that same
> process.  If we keep every 20-year-old reference, our docs will be even
> cruftier and less useful than they are now.

Hi,

the documentation of a kernel should document that kernel.

Now, we have a perfectly fine tool named "git" which allows
for metadocumentation. May I suggest that you respin the patch
and include a link to the old stuff, which somebody has been
nice enough to find, in the change log?

	Regards
		Oliver


  parent reply	other threads:[~2023-05-09  8:55 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-05-05  8:27 [PATCH 0/3] dc395x stale reference cleanup Bagas Sanjaya
2023-05-05  8:27 ` [PATCH 1/3] MAINTAINERS: Drop DC395x list and site Bagas Sanjaya
2023-05-05  9:16   ` Dan Carpenter
2023-05-06  2:21     ` Bagas Sanjaya
2023-05-06 21:01   ` Ali Akcaagac
2023-05-05  8:27 ` [PATCH 2/3] Documentation: scsi: dc395x: Replace non-functional twibble.org list Bagas Sanjaya
2023-05-05  8:27 ` [PATCH 3/3] Documentation: scsi: dc395x: Remove reference to 2.4 driver Bagas Sanjaya
2023-05-05 10:12   ` Finn Thain
2023-05-05 13:34     ` Jonathan Corbet
2023-05-06  0:17       ` Finn Thain
2023-05-09  8:55       ` Oliver Neukum [this message]
2023-05-10  8:57         ` Bagas Sanjaya

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=8536273d-20a4-1993-1381-b50e44701835@suse.com \
    --to=oneukum@suse.com \
    --cc=aliakc@web.de \
    --cc=bagasdotme@gmail.com \
    --cc=corbet@lwn.net \
    --cc=fthain@linux-m68k.org \
    --cc=jejb@linux.ibm.com \
    --cc=kernel-janitors@vger.kernel.org \
    --cc=lenehan@twibble.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-scsi@vger.kernel.org \
    --cc=martin.petersen@oracle.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox