linux-kernel - Re: [PATCH] README: Find more sane first words we have to say about Linux

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20170501092440.58c28368@lwn.net>
Date:   Mon, 1 May 2017 09:24:40 -0600
From:   Jonathan Corbet <corbet@....net>
To:     Martin Kepplinger <martink@...teo.de>
Cc:     mchehab@...nel.org, akpm@...ux-foundation.org,
        torvalds@...ux-foundation.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] README: Find more sane first words we have to say about
 Linux

On Sun, 30 Apr 2017 22:11:35 +0200
Martin Kepplinger <martink@...teo.de> wrote:

> Imagine you're completely new to Linux, just real quick, ok? What do you do?
> Wouldn't having a look at README be under first if no *the* first thing?
> Ah there it is: README. "Linux kernel". nice! So what's that?
> "This file was moved to ...... Please notice that there are several....".
> Wtf!? Why? Can't they just tell me what's going on like a normal person?

So I don't doubt we could put something better there, but can we think for
a moment about who the audience is here?  If you're "completely new to
Linux", will you really start by jumping into the kernel source tree?
Somehow I'm not quite convinced...  It seems to me that the README file
should be aimed at developers who know what the kernel is but are not yet
familiar with the process of configuring and building it.

Thanks,

jon