From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id yLyUItJL2V5QcwAA0tVLHw (envelope-from ) for ; Thu, 04 Jun 2020 19:30:26 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id nWRqHtJL2V44NwAA1q6Kng (envelope-from ) for ; Thu, 04 Jun 2020 19:30:26 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 94C00940B2B for ; Thu, 4 Jun 2020 19:30:25 +0000 (UTC) Received: from localhost ([::1]:49570 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jgvZI-0002Qm-CM for larch@yhetil.org; Thu, 04 Jun 2020 15:30:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:44294) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jgvZ6-0002PX-FR for guix-devel@gnu.org; Thu, 04 Jun 2020 15:30:12 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:38949) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jgvZ4-0002dH-Vy; Thu, 04 Jun 2020 15:30:10 -0400 Received: from [2001:980:1b4f:1:42d2:832d:bb59:862] (port=44398 helo=dundal.peder.onsbrabantnet.nl) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jgvZ3-0003N9-5X; Thu, 04 Jun 2020 15:30:10 -0400 From: Jan Nieuwenhuizen To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: 02/04: doc: Update README to refer to the manual. Organization: AvatarAcademy.nl References: <20200602170004.20721.34450@vcs0.savannah.gnu.org> <20200602170006.4CE5220A26@vcs0.savannah.gnu.org> <87mu5k1p0d.fsf@gnu.org> <87d06fauif.fsf@gnu.org> X-Url: http://AvatarAcademy.nl Date: Thu, 04 Jun 2020 21:30:07 +0200 In-Reply-To: <87d06fauif.fsf@gnu.org> ("Ludovic \=\?utf-8\?Q\?Court\=C3\=A8s\=22'\?\= \=\?utf-8\?Q\?s\?\= message of "Thu, 04 Jun 2020 14:24:40 +0200") Message-ID: <87d06e39z4.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: guix-devel@gnu.org Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Spam-Score: -1.01 X-TUID: ATNq9ixNoLLl Ludovic Court=C3=A8s writes: Hi Ludo! > Jan Nieuwenhuizen skribis: > >>> commit c75a80189fc19f6ff8b4c82d1d1801be6763b6d2 >>> Author: Ludovic Court=C3=A8s >>> AuthorDate: Tue Jun 2 14:50:54 2020 +0200 >>> >>> doc: Update README to refer to the manual. >>> >>> * README (Requirements): Refer to the manual. >>> (Installation): Update URL of the manual. >> >> Hmm, I don't like it! Also, no rationale. > > Someone reported that the list of dependencies (the Guile version in > particular) in =E2=80=98README=E2=80=99 was outdated. I set out to updat= e it and then > realized that that info was already available and up-to-date in the > manual. Hence this patch. Okay... >> ...but as a new potential user of a software I have often cursed the >> makers for providing "empty" READMEs that refer to documentation that is >> neither built (yet) or shipped, or needs a viewer/web browser; making it >> most convenient for them, the writers, and not for me, the reader; >> leaving me puzzled ... "So, you'd rather not have me use your software?" >> >> I'm wondering if you haven't had that experience, and how you look at >> this... > > Sure. Two things: > > 1. People installing a release from a tarball have doc/guix.info > already built. Ah, that's right. > 2. The =E2=80=98README=E2=80=99 also gives the URL of the on-line copy = of the manual. > > So I think the information is readily available. > > My goal here was just to avoid having an outdated copy of parts of the > manual. > > I hope that makes sense! Yes...it looks like this struck a nerve; I'll think about it. Thanks; Greetings, Janneke --=20 Jan Nieuwenhuizen | GNU LilyPond http://lilypond.org Freelance IT http://JoyofSource.com | Avatar=C2=AE http://AvatarAcademy.com