Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 23 May 2018 05:18:24 -0500
From:      Benjamin Kaduk <bjkfbsd@gmail.com>
To:        Eitan Adler <eadler@freebsd.org>
Cc:        src-committers <src-committers@freebsd.org>, svn-src-all@freebsd.org,  svn-src-head@freebsd.org
Subject:   Re: svn commit: r334073 - head
Message-ID:  <CAJ5_RoAMJ8O5uArY9arkXbKHdDnW66Z=tXqjTV7g9vUVJRTH6w@mail.gmail.com>
In-Reply-To: <201805230409.w4N491iB057004@repo.freebsd.org>
References:  <201805230409.w4N491iB057004@repo.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, May 22, 2018 at 11:09 PM, Eitan Adler <eadler@freebsd.org> wrote:

> Author: eadler
> Date: Wed May 23 04:09:01 2018
> New Revision: 334073
> URL: https://svnweb.freebsd.org/changeset/base/334073
>
> Log:
>   README: Reduce the textdump; describe the project
>
>   Rework the README to make it a little easier for new users. This is the
>   first file many will see when persuing the FreeBSD source code so
>
>   - remove some of the text describes how to build. This is better covered
>   in the linked documentation.
>   - add a small blurb for what FreeBSD is. Some users might find this
>   document through features such as github search so they may not even
>   know what the project is
>
>   generally, gear this file for the new, accidental, or casual user rather
>   than towards someone seeking fuller documentation.
>
> Modified:
>   head/README
>   head/README.md
>

Changes to "the first file many will see when perusing the FreeBSD source
code" seem like something sufficiently impactful that pre-commit review
and/or
consultation with other committers would be advised.

(That said, these changes do seem reasonable, on a quick read.)

-Ben



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAJ5_RoAMJ8O5uArY9arkXbKHdDnW66Z=tXqjTV7g9vUVJRTH6w>