From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id WKQxNkjv+mR7AgAAauVa8A:P1 (envelope-from ) for ; Fri, 08 Sep 2023 11:54:17 +0200 Received: from aspmx1.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id WKQxNkjv+mR7AgAAauVa8A (envelope-from ) for ; Fri, 08 Sep 2023 11:54:16 +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 93FC53F6FC for ; Fri, 8 Sep 2023 11:54:16 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=none; 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=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1694166856; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=wItgf33Mcw6iPI50rccZLfrsgRAT+eLTct49n3YNXYk=; b=Zdu7jNxNPjmiwmSQ/rCaf3ZyPbXofXR6LZtB+ejfEc9XnGjGvgwRKdQfWuoB7bjtWyaKr1 1TRcGZnpNKvn60vdAYLMIhs+QPxIAr+9s/9TSGo0cPyegbBqV1uIR8S/jbjS+ro6L3FjHT In4C2SHPwyj2CQm1JpLw7trZkFoIgH1VqPLJO9F40iaXfSjGPpVMpVy3zDFDhTTZiiBcwH BwWYJQzpa7FX7nc+FJTC9Z2vRXTtLOIVCTpRgM7nQoZp1CU/1Il6/KPO5qh+9sFIh4LBZj 69YWl1nbabztKnpuzyquKdqh/sEOqv2qbLozUFIoAlVVG5fzB9ckog9/2YYoyA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1694166856; a=rsa-sha256; cv=none; b=bFAtZ/sJO6b/fTRey/QeXHIFm59x4ncAhdqf7GV+YsAxR8a3fSUaw0i2OflCOHp9SC6MKE W2KWd0PeaIKSWnibecq8YYmfepl89EstPaQgqAP1GT+A7k8tznCqjCTtLZ5BEqsihEZy4+ NLqU9m8QgvXnUvaYhnLBL6/ms9htxO0Fdk7ktYXZQmG8gtnvNJ48/k6hR6TbmcyM/CxThb jgK9LjqfnKzk+s3JnlbWe/hA/swOXYK6GhbiprpbID/AsdXwsDUKtD+SVIzeF0BOPhoC7+ twUMopuNc6PgmpZARvyfgBP/Ki/Yvl2gvX9LvTJhg2uFxjpiazX9VGZc7rDT6Q== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; 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=none Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qeYBW-0005zu-Oo; Fri, 08 Sep 2023 05:53:54 -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 1qeYBU-0005zM-Vr for guix-devel@gnu.org; Fri, 08 Sep 2023 05:53:53 -0400 Received: from ns13.heimat.it ([46.4.214.66]) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qeYBS-0004mj-BF for guix-devel@gnu.org; Fri, 08 Sep 2023 05:53:52 -0400 Received: from localhost (ip6-localhost [127.0.0.1]) by ns13.heimat.it (Postfix) with ESMTP id 37FD230081A; Fri, 8 Sep 2023 09:53:47 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at ns13.heimat.it Received: from ns13.heimat.it ([127.0.0.1]) by localhost (ns13.heimat.it [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id iTMWbD-VApW5; Fri, 8 Sep 2023 09:53:45 +0000 (UTC) Received: from bourrache.mug.xelera.it (unknown [93.56.171.217]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by ns13.heimat.it (Postfix) with ESMTPSA id 04B4130080B; Fri, 8 Sep 2023 09:53:45 +0000 (UTC) Received: from roquette.mug.biscuolo.net (roquette [10.38.2.14]) by bourrache.mug.xelera.it (Postfix) with SMTP id 6715D2994FB9; Fri, 8 Sep 2023 11:53:44 +0200 (CEST) Received: (nullmailer pid 11980 invoked by uid 1000); Fri, 08 Sep 2023 09:53:43 -0000 From: Giovanni Biscuolo To: Katherine Cox-Buday , Simon Tournier Cc: guix-devel@gnu.org Subject: Re: How can we decrease the cognitive overhead for contributors? In-Reply-To: Organization: Xelera.eu References: <20230827135726.y33t55w4cvq6zsvb@X-kone> <874jkift8v.fsf@gmail.com> <867cp4sj7k.fsf@gmail.com> <38242808-2f06-4674-3842-aea1a5378d05@gmail.com> <86v8cop6sy.fsf@gmail.com> Date: Fri, 08 Sep 2023 11:53:43 +0200 Message-ID: <87v8cldm8o.fsf@xelera.eu> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Received-SPF: pass client-ip=46.4.214.66; envelope-from=g@xelera.eu; helo=ns13.heimat.it X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, 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: mx2.migadu.com X-Spam-Score: -3.83 X-Migadu-Queue-Id: 93FC53F6FC X-Migadu-Spam-Score: -3.83 X-TUID: Ojr7wUWjOxL7 --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Hello Katherine, Katherine Cox-Buday writes: [...] > By "standard" I mean the GNU Changelog format > (https://www.gnu.org/prep/standards/standards.html#Change-Logs). As > in: it's expected that commit messages use this format. [...] > In my response I was trying to point out a flaw in your comparison: that= =20 > with style guidelines, which are also complicated, there is usually a=20 > formatter that will do it for me, or a linter that will tell me that=20 > something is not meeting the standard. This is because languages have=20 > grammars, and linters have higher-order system grammars. AFAIU you are talking about the "Formatting Code" /subset/ of a "Coding style", because there is no linter that will tell you if you are following the subset called "Data Types and Pattern Matching" [1]: am I wrong? Back to the git commit message formatting: please can you provide us with one or two examples of how a commit message should be formatted and what linter is available for that syntax? [...] > Here is my channel with things I intend to upstream, but haven't, > largely because of this friction. By "this friction" you mean you miss a linter for commit messages? Or do you mean you do not agree with the style requested by Guix (and GNU) for the commit messages? You are obviously free not to contribute your patches upstream but the fact that you decided not to because it's "too hard" (my executive summary about your complaints about Change Log content rules) to write commit messages suitable for contribution it _not_ a Guix maintainers fault, not at all. Obviously everyone is free to comment, ask for clarifications or proposing **patches**, but it's not fair to say "I'm not contributing largerly because I've a specific friction with the rules about commit messages" (again, my executive summary). [...] Ciao, Gio' [1] https://guix.gnu.org/en/manual/devel/en/html_node/Data-Types-and-Patter= n-Matching.html =2D-=20 Giovanni Biscuolo Xelera IT Infrastructures --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJABAEBCgAqFiEERcxjuFJYydVfNLI5030Op87MORIFAmT67ycMHGdAeGVsZXJh LmV1AAoJENN9DqfOzDkSrWoQAKdRL36/mbEF7B7IyhXSry/b7UmSwOPuEw+VBPDf aBWuD1mi1Nnn6b+tsggZjgL1yD7JwAvvtqpHzx4mVFMHBLPdRzDn6Z5HlKfEp5Ay RW7T3Oi8wo5Pu68iFwN7TxY7bRrwl1E1Qux+QvFgCDv2r9eUXPATEQJ3Zm+8xh2r T3MQ6T4el0PxZCn8b0whhIo9sOKMYEURNEWL68gTUqfdz9Zdh2GpHAux9mGyTWSH +G6a5Qa4/QiAN4iD0rqGNsXj99yqIysEC5m+jJInoSLFM4AxXk3Fi6QyUbGcSro9 j8HKtOvwNeMuqYj26TDISX8t/ZsRjw0jNv0OXc+X7ZD3o6HXAK+tJdWZtYH53V9Y vIa73BfMpuv6iCNZmZYoGtLBvlqwOd8neKNSuemKnpshsgPaDKMi8U04Ag9vscDa +nHT4fN7lCiPrg+sOyK2KinknhHK7Sc2IMt+X3/OIgP7i2wZro10SwuYcQSDFrDI msbwiDPo5Luj5trY7gj70ugRkwP0KVomwnC+99pevJoRcaKVUawSntozFfcCUPUq VhixR9MxbWXh7MtdQV28DyQjDJWmzVUS+42ByzD0yzcpxnY5hF4tYl5j8Z4Suq5R O+gQp4UszIfQkfENMnLegPHYonH8kTyxtRB6njMo+hLFF3bFucN8oQLaOu41HMvT 6bNh =PGj+ -----END PGP SIGNATURE----- --=-=-=--