From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id CC74KyO1T2OxbwAAbAwnHQ (envelope-from ) for ; Wed, 19 Oct 2022 10:28:19 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id KBsdLCO1T2PPxgAA9RJhRA (envelope-from ) for ; Wed, 19 Oct 2022 10:28:19 +0200 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 5B81B3C752 for ; Wed, 19 Oct 2022 10:28:19 +0200 (CEST) Received: from localhost ([::1]:33000 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ol4R0-0006gw-Gk for larch@yhetil.org; Wed, 19 Oct 2022 04:28:18 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:47716) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ol4Qk-0006gf-Js for guix-patches@gnu.org; Wed, 19 Oct 2022 04:28:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:56656) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ol4Qk-0001Wr-AW for guix-patches@gnu.org; Wed, 19 Oct 2022 04:28:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ol4Qj-0000Yd-Ux for guix-patches@gnu.org; Wed, 19 Oct 2022 04:28:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#58463] [PATCH] * doc: guix-cookbook: Add a "Guix API usage examples" Resent-From: Fulbert Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 19 Oct 2022 08:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 58463 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Liliana Marie Prikler Cc: 58463@debbugs.gnu.org Received: via spool by 58463-submit@debbugs.gnu.org id=B58463.16661680542109 (code B ref 58463); Wed, 19 Oct 2022 08:28:01 +0000 Received: (at 58463) by debbugs.gnu.org; 19 Oct 2022 08:27:34 +0000 Received: from localhost ([127.0.0.1]:55734 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ol4QI-0000Xw-4s for submit@debbugs.gnu.org; Wed, 19 Oct 2022 04:27:34 -0400 Received: from vimdzmsp-sfwd01.bluewin.ch ([195.186.120.131]:43258) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ol4QF-0000Xi-Fi for 58463@debbugs.gnu.org; Wed, 19 Oct 2022 04:27:32 -0400 Received: from bluewin.ch ([213.55.244.21]) by vimdzmsp-sfwd01.bluewin.ch Swisscom AG with ESMTPA id l4Q5oDcmZaSptl4Q6o2Rax; Wed, 19 Oct 2022 10:27:25 +0200 X-Bluewin-Spam-Analysis: v=2.4 cv=XueZhXJ9 c=1 sm=1 tr=0 ts=634fb4ed a=okETWHrkPlANAx00SlWV7w==:117 a=IkcTkHD0fZMA:10 a=K1DGZSwWC4ovxIWlpGcA:9 a=QEXdDO2ut3YA:10 X-Bluewin-Spam-Score: 0.00 X-FXIT-IP: IPv4[213.55.244.21] Epoch[1666168045] X-Bluewin-AuthAs: fulbert@bluewin.ch Date: Wed, 19 Oct 2022 10:27:21 +0200 From: Fulbert Message-ID: References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-CMAE-Envelope: MS4xfEDEiNMgLBrNEeG5wicxBzwNg8QxCwvqfIRWSwBGQgWZv5v4Zglb5/AsXcm0oimxvRVoxHSo9eFS1LYPQLFv8RfDfLm38Xni/jT5MpS8lh7xCAjA0gGq ebY8gh0ZAxMAQsGAFgG+wfnO4Z0ZGxLMuwv8vdw3CPyoshUjhVKDhDtEWjN+BoRAKcJX7r7zbB0bjkSUOwDQReqiCesMeYDgqohOSZGmxVStmRMOlpmpHL/2 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" 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=1666168099; 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:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=bUuQVqsUgcodIN4pUxGMJADfMQ+7W/MpDgGqLqFnltQ=; b=LXBEz9qIdHC3ry7Vpu2yYFlaSTmNxXQjQfZWsrC7wFFPs+56QGWdCSyXubeAA4Q3sSNYzF LGfRM5x3ZvAFzWJOKsWQjLGumqMIjFZsrB5y1MSx/Vk4FPrjc3lpo0798nY5/FFXX295Fc nc8sii+a7F/obcrtzHE87fCAZ2Vxgi6C53Rh3mBusKcJgNzcbyTnnhEJwz1Ma6XjfbZM5H 1CXlARBOSXnSmF+fkCAHOdCKcXtiyvMVWJrjsa8+7GrzFEQrnYlgRrPPqaX9WAmFaOjefA myY1V8WD4TJvPh6U3nIdMceNXt7gOgH/FvU5a11uEf+rKuVnokI1oeE50VlSTA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1666168099; a=rsa-sha256; cv=none; b=HkPAF1sPv9ewjQZRm3ZeTWoyy2E+9CfTbWOfxW5uJsmttoq1whipzQQ0jJ2mMk5fPrZMcj xw0AE2UBxQe7pXbK3qaCk9CIw4LyavCYqG5JfGSQr3lCJvkVBds7G8faUyfPUD6AwMHQ8k CKEE+Bcjm0NysXb0LAjpNQUvjkGRlpURAnkKOA2hLWLNfo+9qzwuuF1ZOPthKnCLb6ne4Q 4w33sifmWI/msl+V0H2r61Jf4NxEfu/IRPlhMgmjUkLENanG44Knfc+VJ1kPvSIYaKCxlI i6x0fAp1PHwZ2UeZJt0KJYdZ4cMngnSWNzzWQ8txkNvbLl0yspkmvIDgo+Il/w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -2.63 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 5B81B3C752 X-Spam-Score: -2.63 X-Migadu-Scanner: scn0.migadu.com X-TUID: glwXpjVySPrT Le Tue, Oct 18, 2022 at 02:09:57PM +0200, Liliana Marie Prikler a écrit : > Hi Fulbert, Hello Liliana and thank you for your remarks. As it stands, it's only a proposal and I don't want to spend more time on it unless I am sure Guix [doc] maintainers think it would make a relevant addition to the Docbook. Your remarks make sense to me, and I'd gladly improve it as suggested, except for this : If by “structure” you mean Simon Tournier presentation flow from REPL to script and finaly extensions, then I will not be the right person to adapt it for the Docbook, as I found the video *volumen* to follow a clean, logical and clear path and to which the light addition of this *codex+hypertext* transcript adds quick/random access and searcheability. At present state (including the improvement you suggested), it would be a good balance *for my taste* : easy access with minimal discourse for maximal practical information. Best regards.