From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id wFmNNWyslWNbBgAAbAwnHQ (envelope-from ) for ; Sun, 11 Dec 2022 11:09:48 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id MBNzNWyslWMzVgEAauVa8A (envelope-from ) for ; Sun, 11 Dec 2022 11:09:48 +0100 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 96D3DA04C for ; Sun, 11 Dec 2022 11:09:48 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p4JGm-0001Xi-6n; Sun, 11 Dec 2022 05:09:16 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p4JGb-0001Wt-Hf for guix-devel@gnu.org; Sun, 11 Dec 2022 05:09:09 -0500 Received: from knopi.disroot.org ([178.21.23.139]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p4JGX-00010R-Qd for guix-devel@gnu.org; Sun, 11 Dec 2022 05:09:05 -0500 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 4545D415B5; Sun, 11 Dec 2022 11:08:57 +0100 (CET) X-Virus-Scanned: SPAM Filter at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id V-l9o-Ik4hY7; Sun, 11 Dec 2022 11:08:56 +0100 (CET) Content-Type: multipart/signed; boundary=1a85aa30801fd298507f8949d069e9df04513fd96a93ca1c44d78a1b42f3; micalg=pgp-sha512; protocol="application/pgp-signature" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1670753336; bh=fCL0HZFYxaxfTZoDxq3q3pVVYIZsj3TVT952xQdS3hU=; h=Date:Cc:Subject:From:To:References:In-Reply-To; b=XVe6clRDKd96x/hpNo7w1+g8LNDw9TGmtYrTgjEP/CscRZHbboB6VZVRXHUP4tmFG +AYrOcXmoidSMN2/TIDPWlUBV/pbQkf3LEMxf/rzlFy4O9uHl31Scjm+rAH3DtBsXm crP2/tP0JC4cyuEjrTBbuumQB/JrLV3iQFFmIAFOE2XzpB+dKvBYSYrflyWEQDCihD sQuvWJn+GlTcGSPBFS5Equ5SBfwOVLVT3Drjv27atlr1WZADHUkHUEnl75p0ybtDaK wCOeTJnRW3Qg5kpEe23x1j8Cf/7oP+yyeDrFn8priBajXnXbUVsLkNlyH97S9it9sV 3BKN8JeiH7ooQ== Date: Sun, 11 Dec 2022 10:08:54 +0000 Message-Id: Cc: Subject: Re: Dissecting Guix -- blog post series From: "(" To: "Mekeor Melire" References: <87k02ystuz.fsf@posteo.de> In-Reply-To: <87k02ystuz.fsf@posteo.de> Received-SPF: pass client-ip=178.21.23.139; envelope-from=paren@disroot.org; helo=knopi.disroot.org 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, MIME_HEADER_CTYPE_ONLY=0.1, SPF_HELO_NONE=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: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: guix-devel-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1670753388; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc: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=y67V5HbNdXk/f3bBZ0c6rb9TJpxZ5p/gSW7jo1xzYko=; b=pPOZSWxXWRAxgPiqOBVbVW65q/+0hEQNtDLPaQIb4rlRJfhKlzn6aHAwXPoBf07ljWfBM4 z3OyCteTq3nLp9WYjfV/WPD8XGDElEaNoToEr76Cq2thxy/RjbeKNdO8BmWPQQ3r4En2FV e6DyO0Cuwo3ZpgV2XVlJaJQxC2aJmZjZpHIzi/NLGqMacA0QGkLei0dKfqYp8cQZGhcGYI db/GqLoEu10gFkFWQ0YHxq/D0phkfGy/PqbeDrhWwMvTWA4G9qBGOIzOktys4Wshl8N97l rGlgRonMBwmJcG853X0YCq6UJ77EBBCqPFTWfoCjcN6HEIMcYxZH/JE1ZKr3RA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=XVe6clRD; 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"; dmarc=pass (policy=reject) header.from=disroot.org ARC-Seal: i=1; s=key1; d=yhetil.org; t=1670753388; a=rsa-sha256; cv=none; b=Iok4ABBQNcUFZwu6PLSMUQdAwG7fRFSmsTlBGqEIBKfNKMjK7oS6wn8pAIe7BjbVFUS9aV MZPuHSbdTXl8xmaHgGidIVFUNZGm1EIYUH23oFxd9qyHltNezfPvMpU+hloN8O5/YdHZIO IQRF8WxafYnM+FF+q/d1jogrjmpTEhzydZ2wU3AHBclrmf+2HmK/S0wi53qsQg10MZWYpD ZPtuZR+QDoOml+V1sHRh7kTgtVkykvcsbEmkkIHPcRJ9T7h13k63xiMC+SwlnqUVszCjC+ UIMDMGPuypcH/vYUybREpnLeDCypxSmxxXyCKF10C4zu12AWivIy932DRhCIFg== X-Migadu-Spam-Score: -9.15 X-Spam-Score: -9.15 X-Migadu-Queue-Id: 96D3DA04C X-Migadu-Scanner: scn0.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=XVe6clRD; 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"; dmarc=pass (policy=reject) header.from=disroot.org X-TUID: A+w5aTXgDaEh --1a85aa30801fd298507f8949d069e9df04513fd96a93ca1c44d78a1b42f3 Mime-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=UTF-8 Heya, On Sat Dec 10, 2022 at 9:25 PM GMT, Mekeor Melire wrote: > I think it'd also be fine to come up with the titles during the process o= f writing as sometimes that process itself is insightful. E.g. I could imag= ine parts 2 and 4 to collapse. Maybe, maybe not, you'll see. Perhaps. I think monads are complex enough to warrant their own post, thou= gh. > How'd this part differ from section "12.18 Defining Services" of the manu= al? Along with a low-level description of the workings of services, it'd contai= n a complex, concrete example of a service. The manual mostly has an API refer= ence and some high-level-ish examples. > How'd this part differ from sections 22 and "22.6 Submitting Patches" fro= m the manual? Again, it'd be more concrete than what the manual shows. It'd explain the process by demonstrating the development of an *actual patch*, and showing = how it could be sent to guix-patches@gnu.org. > By the way, the text does not seem to strictly fill columns at a certain = line width. So I did not bother to fill columns in the "patch". Right, I should set up FILL-COLUMNS-INDICATOR... :) > If the purpose is out of scope, then we should not dive in that deeply. E= specially, I'd suggest skip the code snippet. I'm not sure about this. =20 > Here you write "pretty simple". Later you also write "self-explanatory" a= nd "obviously". I suggest to let the reader decide what's simple. Fair. > Before this point, the record fields have been called '"argument"'s all t= he time. I think it's not nice style to carry on a quoted term through many= paragraphs like this. Let's simply write "record field" all the time, inst= ead. This is fair too :) > I think an example for invoking read-derivation-from-file would round up = this tutorial really nicely because it'd close the circle between .drv-file= s and -objects. Okay! And one for write-derivation, too. > Here, in the conclusion, IMHO, there could be another brief listing of al= l fields of a derivation. Good idea. -- ( --1a85aa30801fd298507f8949d069e9df04513fd96a93ca1c44d78a1b42f3 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGzBAABCgAdFiEE6Vh10NblKE5doNlW7ImHg/nqI20FAmOVrDcACgkQ7ImHg/nq I20jDgv/Rxj5M055jXUxs2Y/uGD/sf8mm1xMXMZK+v7VTdHyw0uRJ9e3kZ/mdEoP WCFiLIlUuNC6Q2fbM4CBDBk6MIrK8tP+Qkdsl2tMjFShXyBi5v4n3VuTNNkpiMrb untzLt3lrGUEzxf7QyFtl3ltop2DbUrHgg/8WKmxRy8ZYdDkYCuGsEb83yJYVgG8 ANeKrxjtR8fPBPwqFLUuTChj3MJDUP5Lm9a1i2LK4wV1+cLP/hOVIofJqGinBTB2 byMwfpUbKBGdjF5rfFOhCj4rc7aIUVjbhdZPdifj+JVFOo++y0vCrlGrjeuRN/sI 7Vasvds0hYCjHCQvXe2SmDrIlun7e5MQJCES+5UzgNf3AjSwoC4f1lv7bqClJ5pV PyUp4wGUhRLurAkF+R8C96LJyiDz8if3vLuqpQ/+k8gmQ9KrFMiJb/DufxyuhjH8 x5txjpd8ubQFhK5alwPdPb52S28QX0LMH0rBRf7c2Y3i4kTRUugbBt1eN68NAGgE b9BQEPNH =WaX3 -----END PGP SIGNATURE----- --1a85aa30801fd298507f8949d069e9df04513fd96a93ca1c44d78a1b42f3--