From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id uOTXJrnWuGGuNgAAgWs5BA (envelope-from ) for ; Tue, 14 Dec 2021 18:39:05 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id +CqrIrnWuGGFDQAAB5/wlQ (envelope-from ) for ; Tue, 14 Dec 2021 17:39:05 +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 483711170F for ; Tue, 14 Dec 2021 18:39:05 +0100 (CET) Received: from localhost ([::1]:42870 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mxBlY-00011H-9e for larch@yhetil.org; Tue, 14 Dec 2021 12:39:04 -0500 Received: from eggs.gnu.org ([209.51.188.92]:59036) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxBl2-000113-PR for guix-devel@gnu.org; Tue, 14 Dec 2021 12:38:33 -0500 Received: from mail-40135.protonmail.ch ([185.70.40.135]:54204) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxBl0-0006nF-CE for guix-devel@gnu.org; Tue, 14 Dec 2021 12:38:32 -0500 Date: Tue, 14 Dec 2021 17:38:27 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail2; t=1639503507; bh=xDucAzGkwRmpHug7Ii06ejeaXVztX3aOG4tJU8dQhQU=; h=Date:To:From:Cc:Reply-To:Subject:Message-ID:In-Reply-To: References:From:To:Cc; b=fIty4msGQsjuwa3dM1gUGlkWonwuWV2O4OQUaqbunaAGYVj8njzpeQct9xvtZCnl0 S+gOjDE4YgYTux0gPf3aLDSEb4bW4mQ7RO7kbgOLCzjiNEiwwqe452BqBDMh3xPIuH sgdYEwP4MVvt3VwZgMHhoxqXLfAlc6QBDu0dE7od/+LDlhmPkY+mYJvd8YPebg+UrR ce3EVVGfXvXmQUSQkCZDq5AjEXZaJ/SO9TP9XqxhNll7uDQM4ltskctstonejl3210 doH9X8/JTFGuPTvcSGZIbit3zmyu0h7RWzfnhQNrhzmruebdcjt2YriZ2fHkt5mVeK UYR9QQUlCJD5Q== To: Katherine Cox-Buday From: Luis Felipe Cc: zimoun , Guix Devel , jgart Subject: Re: Guix Documentation Meetup Message-ID: In-Reply-To: <87ee6ffa5d.fsf@gmail.com> References: <87y24s13u8.fsf@nonconstructivism.com> <86lf0osya9.fsf@gmail.com> <87ee6ffa5d.fsf@gmail.com> MIME-Version: 1.0 Content-Type: multipart/signed; protocol="application/pgp-signature"; micalg=pgp-sha256; boundary="------c48e7ffecef742527efceeb3b91bc463cdc7a3ddf755f7c2ef184fb31fef42ea"; charset=utf-8 Received-SPF: pass client-ip=185.70.40.135; envelope-from=luis.felipe.la@protonmail.com; helo=mail-40135.protonmail.ch X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham 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: , Reply-To: Luis Felipe 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=1639503545; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=xDucAzGkwRmpHug7Ii06ejeaXVztX3aOG4tJU8dQhQU=; b=sJsJoQvsKh1VNZHZQDpQ1/IL2oWeAeV7IJ0QA2nBLbVFZLeLpPyHabT4a6PTEf7+j4KggW fxFJknXhWv1yEWWChoGFt9YmGXlaf28zZPvOX9dODdpGGfddh4I8ietIxxbiNTpnf2JJOq T0NNBrf6v3e1XejNbzwLktPy+X/bGvZHj38BYLhXI7qm09AJ1LULD8tp+zkkK0gSNzPyGY AZEUFrAJxyk8tFDdA48jaVAvwN1BHRr4SauOJPJ1Yf4adAcHpYcjM/9OHCgF74k6EaLfwd d4ZH+oCnaYWP/J594k9IEsTjeww29Bqvkgqkg5Qtf4pJzCLCCbzPnrrjL8B/zw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1639503545; a=rsa-sha256; cv=none; b=lK/7dad+oDNE8uEgLzjltXv4LTTfz+LFfHFjV1UtDLHH8h/Eks7Qhh1hX3+dCxiaP6P+wz vaK43JcDmYXIpkmCnExQpCmBtByjS+nwjkkKrAYHJDX6xwb9IG2cANSY1ZWdgYf8+JMXiV 8zkRZ1SfAQwEt+qetx9n+icbR1JK2I/B7GPYQqHjX2bIbFCAjoXp5hqa27S8c23JxO0oaS utr3zsIlHhPycnG7UQT8PincNlPWsiYlWYV7J4LkSe9ZIQH+rMC1DbkIctFw2HwxlHQGaO y5qOzMPVeKbssNT6TFSzi1JUh9BQqp1LkgEizaUTIL23UAdrm3h6ML/pSJsyaA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=protonmail.com header.s=protonmail2 header.b=fIty4msG; dmarc=pass (policy=quarantine) header.from=protonmail.com; 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: -4.67 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=protonmail.com header.s=protonmail2 header.b=fIty4msG; dmarc=pass (policy=quarantine) header.from=protonmail.com; 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: 483711170F X-Spam-Score: -4.67 X-Migadu-Scanner: scn1.migadu.com X-TUID: thT2uXM5gQs+ This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --------c48e7ffecef742527efceeb3b91bc463cdc7a3ddf755f7c2ef184fb31fef42ea Content-Type: multipart/mixed;boundary=---------------------df502b4ea82466b19b4708d7a2764f8e -----------------------df502b4ea82466b19b4708d7a2764f8e Content-Transfer-Encoding: quoted-printable Content-Type: text/plain;charset=utf-8 Hi, On Tuesday, December 14th, 2021 at 4:01 PM, Katherine Cox-Buday wrote: > Guile: > = > - Tutorial for extending a C program with Guile > - The manual > - Scheme Resources > - "The Revised^6 Report on the Algorithmic Language Scheme" > - "" but 7 > - "" but 5 > - (more links that IMO are only meaningful if you already know Sch= eme) For what it's worth, the intention with the structure of the Learn section= was to put first introductory, prescriptive documentation about the langu= age and what is possible to do with it. So: + Tutorials (Guides, etc.) + Reference manuals + Scheme resources This documentation was supposed to fill some of the gaps that have been al= ready mentioned in this thread and other previous conversations during the= years in other channels. Unfortunately, the Tutorials section hasn't seen= any additions since the day the website design was updated. To me, the idea was to focus on building the Tutorials section gradually b= ecause, I thought, the reference and Scheme resources were relatively comp= lete (except for the discoverability of SRFIs and how to use them in your = own project when they don't come with Guile). I suggested something like t= his for tutorials: + Hello Guile: Getting Started (An overview of programming, and how to sta= rt = with Guile) + Hello Guile: Let's develop a console application + Hello Guile: Let's develop a desktop application + Hello Guile: Let's develop a web application + Hello Guile: Let's develop a 2D game + Hello Guile: Let's package your software for distribution (with Guix) I guess it is a matter of filling the blanks, which is a lot of work you h= ave to enjoy doing and have enough time to do. -----------------------df502b4ea82466b19b4708d7a2764f8e Content-Type: application/pgp-keys; filename="publickey - luis.felipe.la@protonmail.com - 0x12DE1598.asc"; name="publickey - luis.felipe.la@protonmail.com - 0x12DE1598.asc" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="publickey - luis.felipe.la@protonmail.com - 0x12DE1598.asc"; name="publickey - luis.felipe.la@protonmail.com - 0x12DE1598.asc" LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBPcGVuUEdQLmpz IHY0LjEwLjEwDQpDb21tZW50OiBodHRwczovL29wZW5wZ3Bqcy5vcmcNCg0KeHNCTkJGOFpwVWdC Q0FETGpoMnVtMkpkbDlCUUtrZ01TZ25ISitzSGg3S3ovdlA5c3dxN0hZTEVuRmc2DQpIQjRLa3Vv V0lxTXlFSnJOYzRrNVJQSGJ4azlxQTB6a0Exd0E4eHYzakErMlVsaVFra1pSMCs0cjlLK3gNCmZZ RGx4ZHd2Sk1VRVJaUk5kb3QvZnFCaGtTYmhpVElTU3pvRUs2ZjNreHdiN3NyME9jSkx2aU5wQ0tv aw0KWVo1Rnc0UXp3Q0Y5V1hja0VmOXNFeGNGYzZDTkdLL0pCVlZaZlZocVZNa3hqUU42YnF1WW56 a3E4WVNoDQo5Z1lTOVgxdmxiZFJBeWVLUmFxNHVqSXV0aVM2djAybDRSRTZ1RjVqaXI4eC9UeDc3 NEZualBCNmdDdWwNCk5TeDZCZmhVTndZeWJ5UFB4SVhYOUpPNHZrT3ZXNE9NZVdjcW1BK1VnQ3c5 Vmk5dnJDN3lISlRGQUJFQg0KQUFITlBXeDFhWE11Wm1Wc2FYQmxMbXhoUUhCeWIzUnZibTFoYVd3 dVkyOXRJRHhzZFdsekxtWmxiR2x3DQpaUzVzWVVCd2NtOTBiMjV0WVdsc0xtTnZiVDdDd0hZRUVB RUlBQ0FGQWw4WnBVZ0dDd2tIQ0FNQ0JCVUkNCkNnSUVGZ0lCQUFJWkFRSWJBd0llQVFBS0NSQTU0 TWRqZWpuR3FWVWFCLzk3UC9WSEtwK0FiRWJMemVkNg0KUEloSHI2NGQ4ek5PN21ibG5Gd056NDlo azdKbVJZTDV2UDJWL21DMDNXSUpmU2ppdllHU2lIbkxSZURFDQpubG1VQ01mM20rMU45OGVBaXFI TkVnNmVpaTMyYXFWUWJheHYveis1OVJHZUtIMkFsdGFkcHNUQWdLVXMNCjFrL2Z0ZEJXVlplYitC QXJHYWlsREU3OHVlYiszWE15Z3ZDV2oyMWZleS81VXZiakhxUjlMNEpZVGlTbQ0Kd1l6N0hmWm8r REU3WUlzY3ptVmVoOE0xVnpDbC8xaWFoazlVRUxqQVAvalArcnVNVDlxRVd1ajJRbGxBDQpNZVBH UnpRYnFpRGhWUzhMRmRqQkhOb0tMeHlobmJERUZqSEYvNHhOcThqbFFMZkdKWjVoS2V0dForYlUN ClNXYUVYRjNoano5V1dVOGE1Sy8yTS9Ib3pzQk5CRjhacFVnQkNBREtVblJJOXl6NFJ2TnV2U09J RmxKdg0Ka2ZvSGVaci9CTGNTR1ZjU0JreDVsc0tkVnpNeDkrVWFhZUtqV3BJTyt4ZkVOc3o3YitC Vm9CTDBXcnY5DQo0aGx3V21HNXEwQWRFeVUxL2ZRc1JSN201TzFlYTZVVDNmdVVnMVZzakZaK1Iz alN5bEF0eXpJWk0wTFUNCmJXNUY2NzNLNEF1U2NGcE44TkxHVGdScjBXUWwvQm5Id2gyWFExeHFo YzZHQk92d2l3VkJqYWY1MFNIRQ0KVGlVUHBlM0pqUXl5QlpwKzhGS20rc25ScUNHWG4wSkc4bzBG WHk5V2N4dHZmUUZNTUpwOUJPMnl0Z3hIDQp6UUlwWWNKcEpadWNjbkZvcXFIOWorMXFYWE5TYTMv cU8zenU5bFN2WFR4eDZrZGgwRldUbllDeDhNZjgNCkJZL1BXL2JCT095aExDb1RrSHFsQUJFQkFB SEN3RjhFR0FFSUFBa0ZBbDhacFVnQ0d3d0FDZ2tRT2VESA0KWTNvNXhxa2VLUWYrSk1sY2JSbHdl aC9GQTFudzh6RkN4YUY1OFBOREVPOGxIOTIveHR6bndHZEF1bHpUDQpoWjQwakdURWlweWdzbnFI VjdXSFVmNDRuZVhuMkExY3ZDWis3M0tjcGFRTmg5TXA4eVduR0taWVVHa0cNCjZPZjFoRVU3OTJY WkV4a3lBODJQZ0xCTlkrVnpOWFhLQ0g3Tlh4WlFRV1Y1blhjYlVGQ1p5Slp1ZFNnUQ0KeGsxOXNR ZjRzOXZKWDZQQzY4cXdpN2FKMTduVmZyYmNNYXlScG0yT0dKWGQrdDkxVi9Mbk5wQ1JndGwzDQpq TllzQ0JGS0RDMFl4ZEEvTkNkRWsxZ2Z1akZ6bDBiQnM3KzVKYmQzelJhRTVBZmRWUXRJbG1FWERr VzYNCjB1eUVpM050Y3E1b2RYQTFubFIrZTA0NEtGdmVaekZ1Tk5lVGdzekFCcjVIaVU3MC9FbHlz dz09DQo9ejZlNw0KLS0tLS1FTkQgUEdQIFBVQkxJQyBLRVkgQkxPQ0stLS0tLQ0K -----------------------df502b4ea82466b19b4708d7a2764f8e-- --------c48e7ffecef742527efceeb3b91bc463cdc7a3ddf755f7c2ef184fb31fef42ea Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: ProtonMail wsBzBAEBCAAGBQJhuNaEACEJEDngx2N6OcapFiEEEt4VmH0cRaQ093DvOeDH Y3o5xqlW1Qf/TYFp2Xix6jMEfWkKXK1ZsCvgfnHxxHAg9bOPGejkG1VNgtfw XzgYALPV1oopzvIcRFdVgXtQz5LEunT410txCVuclwv/6FX5bw9rjc/HWes7 ahCptAlwQP+/O8tSDhDiKWS68w/NVqvBgglkCKt0QNeMqBAxjzc+W/nrvAK8 8DFbK0MU4l2ovzlQd6+WofB09EW7G8kmuUoWa778dV9SfGeWj+K2M6fvNdch QbU3tOM/0rlqj7KzEo32ZnLy2Fs4mLb/iHFVhDxET5nnndXmy1Ussap1a3J3 wKLwmsDq/9faUjN3EnZXNyo5rqA/bFw23AhfQqHdY9Oh4rJ75yt9wA== =nWcL -----END PGP SIGNATURE----- --------c48e7ffecef742527efceeb3b91bc463cdc7a3ddf755f7c2ef184fb31fef42ea--