From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Date: Sun, 25 Jun 2017 22:56:07 +0200 (CEST) From: Jiri Kosina To: Mauro Carvalho Chehab In-Reply-To: <20170624104142.70677fcb@vento.lan> Message-ID: References: <20170623123936.42dab05f@lwn.net> <20170624074641.4820fecd@vento.lan> <1779146.rtcHP5MkoH@aspire.rjw.lan> <20170624104142.70677fcb@vento.lan> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Cc: ksummit-discuss@lists.linux-foundation.org Subject: Re: [Ksummit-discuss] [MAINTAINERS SUMMIT] Documentation issues List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , On Sat, 24 Jun 2017, Mauro Carvalho Chehab wrote: > > There are pieces of .txt documentation falling into the "well-knows source of > > information" category, with many references to them all over the Web. > > kernel-parameters.txt is probably the most spectacular example here, but there > > are others. > > > > Let us not move or rename these, please, or at least put symbolic links in > > place to point to the new locations or similar, such that the existing WWW > > links pointing to the documentation at kernel.org still work going forward. > > > > And if we have moved or renamed them already, can we possibly make these > > links work again somehow? > > Agreed. We discussed in the past about two alternatives for those > "well known" documents: > > 1) write a small text on the old file pointing to the > new location; > 2) use symlink. > > Right now, we're actually mixing (1) and (2). IMHO, we should either > do (1) or (2). Unfortunately option (3) has also been applied to some of the files: $ ll Documentation/kernel-parameters.txt ls: cannot access 'Documentation/kernel-parameters.txt': No such file or directory I wasn't sure whether this was intentional or not. But if not, I'll happily send a patch that introduces a symlink. -- Jiri Kosina SUSE Labs