From owner-svn-src-head@freebsd.org Wed May 23 10:18:26 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 94D35EF7CA6; Wed, 23 May 2018 10:18:26 +0000 (UTC) (envelope-from bjkfbsd@gmail.com) Received: from mail-ot0-x235.google.com (mail-ot0-x235.google.com [IPv6:2607:f8b0:4003:c0f::235]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 112E7821C0; Wed, 23 May 2018 10:18:26 +0000 (UTC) (envelope-from bjkfbsd@gmail.com) Received: by mail-ot0-x235.google.com with SMTP id 77-v6so24556163otd.4; Wed, 23 May 2018 03:18:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=SLbwgoV6dcs6s+Ye7fFGXCmlg1IBf84gZx5aRwzMe/4=; b=F3wzUjVAuNFhEUIXtyHTP6CBTHEdjk6m8lpW7fWm6i26tXnEsbsTP3+tmXngCUnGMh kIKBYUs+HniG10MkBYKtVR96Djapl2CnUGui3ZV8s8Sdg6KmWzniPMSVlCy+d7npOQhQ TGIzzQM9KHHqDCdWzbUnz2gf3X8y+vu9u5oAXFCRWDjovTfwEzbpSdlkn/kxA6DbtpaJ HZGJOoysq2cCpqseWRTnsnE9f9ZagsN/5BrGHZu4JLSjJ3S+Oa2Cw3bpKgsE7HPzQ3cq jyHgUza1BkTtyw8yM04oMr0epKmH2J95KtGL+iGdeDccXbXyq20hih536FcAyTGC36mV cdvg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=SLbwgoV6dcs6s+Ye7fFGXCmlg1IBf84gZx5aRwzMe/4=; b=UwBfFCKCZOdjh7Yot+rBmQhFpxZ5mUxup5arRBbGOBWORR92CHMCAy7ffrs5a/rNmy ZLZy3X03QXXmL9JD7JQO7flkuPHvSJljx5rhDZ7q7isnTzCvLzzTDzkyIHX3rTNtbh2n +JU5jqL1A8MZ5EOgpHCwIKT7iLF+nW5RIfrKacrF4GRA5M2qXjZG5SFRjeV8CDjtqvTu cbeyF59ZL/ob07U3J+wnsahaDC43c9ZE7g8zYgDNHu58Swmbcu34TuV4iu1d9mPqqDli VW4/WdKIiR2Rhyqj4QPPI+KDfg/MGZbWgHxLTUSq9bYX/IHQ42QbGHRcXBZHkDXhmuzP nWrg== X-Gm-Message-State: ALKqPwe2FFtmPHBnRmDFfxiNCtxHVuAG06jino74TQQIusYp5src6AA7 cD8grILIHyacwwSM4kmd2S58XPyrWFanl8TjKOk= X-Google-Smtp-Source: AB8JxZqSKEM69dITDDmju08zf+fif/Vk3p8JIWpqAamjR8z01+O4BQpclpuBm49mWKA4NNLTI64G0NIrxRTGXsV5X20= X-Received: by 2002:a9d:2842:: with SMTP id h2-v6mr1430351otd.210.1527070705088; Wed, 23 May 2018 03:18:25 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:a9d:348e:0:0:0:0:0 with HTTP; Wed, 23 May 2018 03:18:24 -0700 (PDT) In-Reply-To: <201805230409.w4N491iB057004@repo.freebsd.org> References: <201805230409.w4N491iB057004@repo.freebsd.org> From: Benjamin Kaduk Date: Wed, 23 May 2018 05:18:24 -0500 Message-ID: Subject: Re: svn commit: r334073 - head To: Eitan Adler Cc: src-committers , svn-src-all@freebsd.org, svn-src-head@freebsd.org Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.26 X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 May 2018 10:18:26 -0000 On Tue, May 22, 2018 at 11:09 PM, Eitan Adler 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