From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Blake Shaw Newsgroups: gmane.lisp.guile.user Subject: Re: Proposal: Deep Dive into the Guile Docs & Makeover Proposal Date: Tue, 08 Feb 2022 18:46:55 +0700 Message-ID: <87pmnxmvgw.fsf@nonconstructivism.com> References: <87tud9olma.fsf@nonconstructivism.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="40767"; mail-complaints-to="usenet@ciao.gmane.io" Cc: guix-days@gnu.org, guile-user , guix-user@gnu.org To: Neil Jerram Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Tue Feb 08 16:01:14 2022 Return-path: Envelope-to: guile-user@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nHRzV-000ALu-7n for guile-user@m.gmane-mx.org; Tue, 08 Feb 2022 16:01:13 +0100 Original-Received: from localhost ([::1]:50742 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nHRzT-0006PT-SR for guile-user@m.gmane-mx.org; Tue, 08 Feb 2022 10:01:11 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:36362) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nHOxc-0006W5-4W for guile-user@gnu.org; Tue, 08 Feb 2022 06:47:04 -0500 Original-Received: from [2001:41d0:2:267::] (port=32472 helo=out0.migadu.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nHOxZ-0003Lg-Qu; Tue, 08 Feb 2022 06:47:03 -0500 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nonconstructivism.com; s=key1; t=1644320818; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=50ZEYye8uIDrqFUROM2FqZ1GQj8D26bTyGnlZnpoxCk=; b=iC3Wh+0p9ET4CFAiCoPYzcg+YonFI5uSwvaaKPEJiu+cbr4VdR/WF6lzmqOK79zsJ2GosJ 2p4Ey+rAS7PoQJvJeEypFFVSscWSIgL6F1GWd4JZFLS/gGn23c3X0kDtty2fiNh0WRW+bL 1DLbmaE+AH8E9gZEhGj7CepI72/sWC8= In-Reply-To: (Neil Jerram's message of "Tue, 8 Feb 2022 09:07:53 +0000") X-Migadu-Flow: FLOW_OUT X-Migadu-Auth-User: nonconstructivism.com X-Host-Lookup-Failed: Reverse DNS lookup failed for 2001:41d0:2:267:: (failed) Received-SPF: pass client-ip=2001:41d0:2:267::; envelope-from=blake@nonconstructivism.com; helo=out0.migadu.com X-Spam_score_int: -19 X-Spam_score: -2.0 X-Spam_bar: -- X-Spam_report: (-2.0 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Original-Sender: "guile-user" Xref: news.gmane.io gmane.lisp.guile.user:18034 Archived-At: Neil Jerram writes: > Speaking as one of the past authors of the manual, I look forward to > hearing your thoughts. It is genuinely challenging to present this > amount of material and explain its complexity, and there is no reason > at all to consider any current arrangement as cast in stone. Thanks > for thinking about this. > > Best wishes, > Neil for sure. on the guix list a lot of people expressed their frustrations (many which I share to be sure, which is why I'm drawn to work on this), and some suggested solutions of "we should follow x format". while I understand that sentiment, I as a recovering academic who has helped friends with countless dissertations I also realize that too hasty judgements in an editing process can lead to frustrations which ultimately stall progress. nonetheless, I'm pretty confident that most of my proposal will resonate with the newcomers and old timers alike, and folks will agree to let me move forward without getting bogged down in bikeshedding. it's been quite a trip learning guile! and I'm happy I've put the effort into it and hope I can contribute in such a way that will make it a smoother process for future newcomers :) --=20 =E2=80=9CIn girum imus nocte et consumimur igni=E2=80=9D