From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id AIiyJDlS+2RqeAAAG6o9tA:P1 (envelope-from ) for ; Fri, 08 Sep 2023 18:56:25 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id AIiyJDlS+2RqeAAAG6o9tA (envelope-from ) for ; Fri, 08 Sep 2023 18:56:25 +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 5AE3E457B5 for ; Fri, 8 Sep 2023 18:56:25 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=nFlmK4wD; 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=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1694192185; 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:dkim-signature; bh=tu1tEtVAVa5K6Emeo55U7oQPKONlKEWgL03Zqe5OQMA=; b=LqFX4pPRHVcz3Dhmjr2Kc/L+tSCs2gNy+9JELEndIQG25dhvPutl0v02XDmtFnT6CCK5NG h3PET5CVwKKyfpJTgkIgTieBPY/6Lbwmn8AR59ad20JITv/yclPdLLNPb4fCm5xEm/m0wq BRvZGhgyqj1Fa4+vuNxsRRMSErp96AnWbTY8iA00VrLc8z60pLPOqXvQNr5ekzTXkyZvi4 i5jFDmrI3a3SqwCSplL4wpvzVm4/WJYhGh3BXAQQE8C/ie2wJs2PXBbBlA+2PgtJs5xubq TckwEHmhyxWZsb0PNmp5iyDfHHdfr35fCRmYSKqYNq1mTpzBEZl1uxkmubFFzA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1694192185; a=rsa-sha256; cv=none; b=kObdxKOAp/ry3Yb+6mcO3w93JAKd8xFiswq41UytO7JwN/TEwgkYEMpf/LG9KxEbcYUdtE /0vWl8ISslgrU6aKz2mgR+EaReqMIOP3E3l524gf/k85GNglUPLZBbA9aJ55zGkbLtnsS0 qz+58bY+HX7trvFVbSBrbP7GXyfqqOeMAHUWYPHWdJKcE3K9ydszSLhSLOyXjbpK0BovRi hZqfMtG8Rt2aR1JScd36tVdc8fa5+AXeO5yi2GJ2+pUKp8wqSiAbJasFIi99npK6u6U9ie 1j5/kYJ8GCiQ8QkLpXe51srAzoIAgO21GQ14gOZvRvLMQe0n/edXTSdLq6N3WA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=nFlmK4wD; 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=none) header.from=gmail.com Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qeemB-0001Jj-7z; Fri, 08 Sep 2023 12:56:11 -0400 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 1qeemA-0001JW-1N for guix-devel@gnu.org; Fri, 08 Sep 2023 12:56:10 -0400 Received: from mail-ej1-x642.google.com ([2a00:1450:4864:20::642]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qeem6-0007Ol-06 for guix-devel@gnu.org; Fri, 08 Sep 2023 12:56:09 -0400 Received: by mail-ej1-x642.google.com with SMTP id a640c23a62f3a-99c136ee106so280462166b.1 for ; Fri, 08 Sep 2023 09:56:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1694192164; x=1694796964; darn=gnu.org; h=mime-version:user-agent:content-transfer-encoding:references :in-reply-to:date:cc:to:from:subject:message-id:from:to:cc:subject :date:message-id:reply-to; bh=tu1tEtVAVa5K6Emeo55U7oQPKONlKEWgL03Zqe5OQMA=; b=nFlmK4wDSr64LrH+g6x4/aF0UbGn9iP8pVtktKtDB5Vb7zEEFos83GAJCr3TozAWsL IIQVXVoCOn8Im9qAHpGgZNEUNlhY7wICyX687WWQ4PBx+7WlPyepfPeGBtjE1wMxGJm5 iN8DNbJzHsDFOFk7DWPiyluLWmp4w4kvuuAtWkHpbnO3k57TpClhOjPXCbXTgzoZrXV8 jTFOAKGQM4fBK1rudOYbf1iVdnJLdDB2GD2AmQRbRDcAe837zOZLB7Pa7M/QVROSzB8+ p29P59lnKp0M0P80yuiXzxlHC2cwSJ/bjwCAUSQyDm797VtA7so/w40c9FXRI+mfW3dP f9Eg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1694192164; x=1694796964; h=mime-version:user-agent:content-transfer-encoding:references :in-reply-to:date:cc:to:from:subject:message-id:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=tu1tEtVAVa5K6Emeo55U7oQPKONlKEWgL03Zqe5OQMA=; b=rq/tXmqzZQQrw66M8xvB/Ndol3jTci7VJjFFHtDOLkk6P0KgArhW0HmNFzhCHYW+8T qN2pwWTxC13djhZLCFRTa7EmzKBBmSdvYBgSXNHdhbGsmfUl5z9P7K9juFpcrEs27fQJ VqAA2JzlBgkyuGhwZUMLsHHkSj6xdn6mAvRsniVdF7cQa1iPci9FqGD7ttU4fAi7YrAF RdVGT7KcpH3utSjXHKyyDutSS5vAuXCWaR3mvtJSFcPgQ3LTzdRHG5plkzm2K39/2Sms BiBDyoG+dh3TfaZbGhnCkcd2jCTLjd6YMhHTwStGen/78eB4Cyvp10VoHQuKxDzt7V02 Ezrw== X-Gm-Message-State: AOJu0Yw37heYuryD9Wq6gDRji0Hnpx472tNZvARi6ct0yWeBP1e50LhQ w0wWUPAIUFK0r59hjGuuPok= X-Google-Smtp-Source: AGHT+IHgooEA1rQZhnX3xMH5L/Y84AIy8I8Y+Ut26t4KbrSGKRR/XmWE3zDoTQ5iQA1hVC3tnII4oQ== X-Received: by 2002:a17:906:1011:b0:9a2:2635:daa8 with SMTP id 17-20020a170906101100b009a22635daa8mr2414755ejm.56.1694192163935; Fri, 08 Sep 2023 09:56:03 -0700 (PDT) Received: from lumine.fritz.box (85-127-52-93.dsl.dynamic.surfer.at. [85.127.52.93]) by smtp.gmail.com with ESMTPSA id x18-20020a170906805200b0099cadcf13cesm1267370ejw.66.2023.09.08.09.56.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 08 Sep 2023 09:56:02 -0700 (PDT) Message-ID: Subject: Re: How can we decrease the cognitive overhead for contributors? From: Liliana Marie Prikler To: Giovanni Biscuolo , guix-devel@gnu.org Cc: Simon Tournier , Maxim Cournoyer Date: Fri, 08 Sep 2023 18:56:01 +0200 In-Reply-To: <87y1hhdnzj.fsf@xelera.eu> References: <20230827135726.y33t55w4cvq6zsvb@X-kone> <874jkift8v.fsf@gmail.com> <867cp4sj7k.fsf@gmail.com> <38242808-2f06-4674-3842-aea1a5378d05@gmail.com> <87a5u0o3z2.fsf@disroot.org> <87sf7s9oi9.fsf@spork.org> <67115f26712acbb1d83b71f4418c682a5e9762a4.camel@gmail.com> <87h6o7mbo2.fsf@wireframe> <87sf7rqhqw.fsf@gmail.com> <87y1hhdnzj.fsf@xelera.eu> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.46.4 MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::642; envelope-from=liliana.prikler@gmail.com; helo=mail-ej1-x642.google.com 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_DNSWL_NONE=-0.0001, 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 X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -0.11 X-Spam-Score: -0.11 X-Migadu-Queue-Id: 5AE3E457B5 X-TUID: TSQR6hD9ikmf Am Freitag, dem 08.09.2023 um 11:16 +0200 schrieb Giovanni Biscuolo: > [...] >=20 > > > On 2023-09-06, Liliana Marie Prikler wrote: >=20 > [...] >=20 > > > > It's=20 > > > >=20 > > > > * file (variable)[field]{do you need 4 > > > > levels?} >=20 > The general form of a ChangeLog Style format for Guix code (Guile > with gexp) could be rewrote as: >=20 > * relative-path-of-changed-file (variable) [field] : > Description of change. >=20 > I never saw a {4th level} so AFAIU is not needed, unless someone have > a good example plz: in this case we could add a 4th level to the > general description. I have seen four levels in the wild. They aren't particularly large in population, but then again, the third level isn't needed in most cases either. I think we should start out with (variable)[field] as the one that covers most changes. Btw. on the extra spaces, is there any consensus on whether to put them there or leave them out? My personal style always leaves them out. Anyway, looking forward to seeing your series. Cheers