From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id MN+8ODLSwGGCzgAAgWs5BA (envelope-from ) for ; Mon, 20 Dec 2021 19:57:54 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id yLlnNDLSwGHbXwAA1q6Kng (envelope-from ) for ; Mon, 20 Dec 2021 18:57:54 +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 AB1D12B72C for ; Mon, 20 Dec 2021 19:57:54 +0100 (CET) Received: from localhost ([::1]:53224 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mzNr7-0005HS-PD for larch@yhetil.org; Mon, 20 Dec 2021 13:57:53 -0500 Received: from eggs.gnu.org ([209.51.188.92]:53806) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mzMjQ-0007Gt-2V for guix-devel@gnu.org; Mon, 20 Dec 2021 12:45:53 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:58650) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mzMjO-00063o-1v for guix-devel@gnu.org; Mon, 20 Dec 2021 12:45:51 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 3ABEE427; Mon, 20 Dec 2021 18:45:47 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id E2B0pUDNiGP1; Mon, 20 Dec 2021 18:45:46 +0100 (CET) Received: from ribbon (91-160-117-201.subs.proxad.net [91.160.117.201]) by hera.aquilenet.fr (Postfix) with ESMTPSA id 6B908199; Mon, 20 Dec 2021 18:45:46 +0100 (CET) From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Blake Shaw Subject: Guile documentation References: <87y24s13u8.fsf@nonconstructivism.com> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 30 Frimaire an 230 de la =?utf-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Mon, 20 Dec 2021 18:45:45 +0100 In-Reply-To: <87y24s13u8.fsf@nonconstructivism.com> (Blake Shaw's message of "Sat, 11 Dec 2021 05:40:15 +0700") Message-ID: <87zgovf9va.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spamd-Bar: + X-Rspamd-Server: hera X-Rspamd-Queue-Id: 3ABEE427 X-Spamd-Result: default: False [1.15 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; TO_DN_ALL(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; R_MIXED_CHARSET(1.25)[subject]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; MID_RHS_MATCH_FROM(0.00)[] Received-SPF: softfail client-ip=185.233.100.1; envelope-from=ludo@gnu.org; helo=hera.aquilenet.fr X-Spam_score_int: -11 X-Spam_score: -1.2 X-Spam_bar: - X-Spam_report: (-1.2 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_PASS=-0.001, SPF_SOFTFAIL=0.665 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.29 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 , jgart Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1640026674; h=from:from:sender:sender: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:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=5aW6dqs4cF1jQUR9x6d1b+Z/aZZGdAaZQgpZ4j0Sg70=; b=iJ12y7OLAkbKO5SSNr6ZWtZp3bENL3FqTp42lNQXJeK1Vwv7scdh9li7ec9MMaT+j3G8j3 4U2BT87sCUBM5kZx81t5CUjLDkjksi/Pievnd9zBx+U5h5i4OGELS3DN7BWPlAf90cLYp/ QHKSSx8c8jrfHIaOVZESMc2oKrGDWSAjms9BHxABMIf5Vics4L1suulqYp+R6DkzhTuI8j HZZsvhXh5whBATptFwQ/ci6uAFdNm3YIxJUjMqwkCYKLkIT/7D4WLS2pzLm5ztFMPcF8Ei 2JZxSLavKDJh1Gjta8phg2SfK/rgXGSXLlP2u96YZplUqALjz02sEIaWFII5VQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1640026674; a=rsa-sha256; cv=none; b=ZXrAvF/Y9Onnaaeg0ZSKCrpM/VWUc/bJVcayw8afyLtqQEezYK45lOFZXxaLM0Smrt8GZO rklGBZk/jL+IFf/FAHhi3952035BOjXxm/goEeRSWt+nrefwyX6OSjxHQR3nuSv94AdnqY +80rimlcrOU3qaaYwO4JMRmmwUMXKviwmO3mswPxd5jfKwySLaA8d2xbb6fkqWO7co7jAk q2xDVrQcYKMOC3Na4qtoZv1nZ4yLOl7xFURKSXjW4T3aCOmKqqPBiQO+E/UFrl+rZzmMt5 ej5MkMvSiIjW4k8Tpf69xHu9naPTFcyjJuat7cjMku6XpLDSg2mQZGWg0lQDSA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.02 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: AB1D12B72C X-Spam-Score: -3.02 X-Migadu-Scanner: scn0.migadu.com X-TUID: Bn+4iDS1c9yb Hi Blake, Blake Shaw skribis: > While I've come to love Guile, compared to my experience with Racket its > been quite burdensome for me to get in the hang of, something I attribute > primarily to the structure of the docs, and not due to it being in any > way more difficult than Racket. While with Racket I was writing > useful programs in the standard #lang within my first week, with Guile > I often find that what should be almost trivial winds up with a lot of > time lost just trying to navigate and understand the docs. When I do > figure things out, it turns out to be no more difficult than the equivale= nt > in Racket, but a lack of consistency in the path that leads there in the > docs cause hangups, which has made trivial scripts that should take an ho= ur > become weekend projects. IWBN if we could take advantage of your fresh eye to restructure the Guile manual in a way that makes it more convenient. Guile has changed a lot since the manual was initially written, a lot of sections were added, some removed, but we probably didn=E2=80=99t take the = time to sit down and see how to restructure it accordingly. So if you have a specific structure in mind, or if you remember precisely what was hard to find and located in a unexpected section, please let=E2=80=99s take advantage of that! Thanks, Ludo=E2=80=99.