Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1633704

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

From Jonathan Corbet <corbet@lwn.net>
Newsgroups linux.kernel
Subject Re: [PATCH] README: Find more sane first words we have to say about Linux
Date 2017-05-01 17:50 +0200
Message-ID <tClKi-2vD-15@gated-at.bofh.it> (permalink)
References <tC3u1-7Kl-5@gated-at.bofh.it>
Organization LWN.net

Show all headers | View raw


On Sun, 30 Apr 2017 22:11:35 +0200
Martin Kepplinger <martink@posteo.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

Back to linux.kernel | Previous | NextPrevious in thread | Next in thread | Find similar | Unroll thread


Thread

[PATCH] README: Find more sane first words we have to say about Linux Martin Kepplinger <martink@posteo.de> - 2017-04-30 22:20 +0200
  Re: [PATCH] README: Find more sane first words we have to say about  Linux Jonathan Corbet <corbet@lwn.net> - 2017-05-01 17:50 +0200
    Re: [PATCH] README: Find more sane first words we have to say about  Linux Martin Kepplinger <martink@posteo.de> - 2017-05-01 18:10 +0200

csiph-web