From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.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 0OfHJcTo92QtGQAA9RJhRA:P1 (envelope-from ) for ; Wed, 06 Sep 2023 04:49:40 +0200 Received: from aspmx1.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id 0OfHJcTo92QtGQAA9RJhRA (envelope-from ) for ; Wed, 06 Sep 2023 04:49:40 +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 8954D3A004 for ; Wed, 6 Sep 2023 04:49:40 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=gBHuQTi1; 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=1693968580; 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:dkim-signature; bh=D8JosnwPjLU2GOndSqxpSTkbzUQIb9r6MoVA0mTiXDY=; b=tEv/Ag0xYxtxZA+iowJ0HAXGVNRtirUUI1N/FtWkomgumeEBpopcxF+6LIJCLdLsNm+yL1 JmV4IZZKhx+0nUj1ju47nIus1Ak8XL00p1rPm6AmfsljZsdQpWBrLcRo5jLMzCklde6Qez 3DL1Xfnis9uxZG+jhdpxfAuEuRc89xT/CcamHE4w7gAEHzyGmAboi3p96+C6K+kjNkta6u UiH1DBUngOS9y7ZH675wtz1B1AMkbz8wCGYGcZ8uH2eaZqB+rXEvaE356Nm5N25rt+NTR3 nzaS164BcDRcKIPLA5IT/HC+jI4Wi4esG99zOjjDUij9MtK9Y492fSGKPi0Yjw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693968580; a=rsa-sha256; cv=none; b=Cwn2vNXHx6I9cFkAaXgBZSkgDAzhdwvEVHPi+xLqKsbvMUY+8Ceql7lKtYuHzex1y5/nBQ whuDdvuxrJ4awgs8LGE82xWAMppv5RLS3nz2/KCshi4TE6FFiwMxhJUhuMJDzr+qYoLkef 2+iY6kIUNrqL/hqgQJns78UiuJUOLyyXkyVCLenmgcXI4zsFpsL79ghKxDae4d6mmqJC32 MQua41+I2Htan3pbbqw4q03xAExTrlkX3LoyzpL1u1moiwRPejN1JHUyJB8ENVWQ/Y3Aky J5Wt4WttojYn9RNXaRdH7dlC2G4r+NerCP8pgbR8Tmrulo98XNXcZpxDSd4NbQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=gBHuQTi1; 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 1qdibO-00005X-3T; Tue, 05 Sep 2023 22:49:10 -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 1qdibM-00005O-Mw for guix-devel@gnu.org; Tue, 05 Sep 2023 22:49:08 -0400 Received: from mail-qk1-x72a.google.com ([2607:f8b0:4864:20::72a]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qdibK-0002Ar-Kk for guix-devel@gnu.org; Tue, 05 Sep 2023 22:49:08 -0400 Received: by mail-qk1-x72a.google.com with SMTP id af79cd13be357-76dc7b0da9fso161001685a.1 for ; Tue, 05 Sep 2023 19:49:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1693968545; x=1694573345; darn=gnu.org; h=mime-version:user-agent:message-id:in-reply-to:date:references :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=D8JosnwPjLU2GOndSqxpSTkbzUQIb9r6MoVA0mTiXDY=; b=gBHuQTi1WvY6z5tYyqR7vZRbOrPGL7fAAGw4clXSe1LKdI0oFbROS6vxmwj6G3/ozv NgV616H/rfc8X85ecBtk6JXj+uu2W1nGW0paOrcf9wQT6z9uwwTTXstsm26e7dhyCVwx es34Sd2tNEeD8w69pD23OSlnog/LmMh5n+e51J/wpPgGxL06MQJEsTRtCZSWiVq0O8Sc A8if/ohIrIhZj73rcuOgntCCv4SWM0Zot1eZgQbY023FoBwTF8muG521P+MeuGGQSpTh uk9FIGrff2Twojt+TmDnRXol1T3Cb3TY5VIBqtJfh4OfY5pVKm9XX0uKcsDmLs/JB2pt VjgA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693968545; x=1694573345; h=mime-version:user-agent:message-id:in-reply-to:date:references :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=D8JosnwPjLU2GOndSqxpSTkbzUQIb9r6MoVA0mTiXDY=; b=IrsNPOlPBXgKhA9N7T4y4ZkkfOu1NJMyrkEuVyHYGKkmHJX+Fog1vyWXdJB56IG21+ cE6PiTxMFzCp6spKWcRzp07UviwnKoxf9IOy8nljfD643TXT/XpB742CFBfQn072+oDF w/Fd5wZuuzIgGwM1bOFveKBriZlSSYyQr9kRFNk4MX3JoZ24hnnT7Y0Lpu0GZWGtXafp 2adZhdcfTxKahQd4aBZMMiq5XW3EGPOquXPB3V65qRPZDe+QWkZ5N7Kv6iprk+VjFI+r LXZ1XghaC16dX9JB4JikF8y/w05QdWKdwSHoEj5wNbbjOtzeeSMYDn0KC/uAbhKvRha6 X3yA== X-Gm-Message-State: AOJu0Yyqr/yGLcuG+eYtUQyb8JMSwT0LOFb6vmO3Rsmhag/a6hUu5rHO ojcQ0S7reW9biT25wTMWxdix2c+oSjA7xw== X-Google-Smtp-Source: AGHT+IGt06QmzqjTIstPbHhhThWP1qs8UKphDzq3WckNBjxiU+3YjrA9NRMs1bnE1iHHpmlIB9su0w== X-Received: by 2002:a05:620a:81c:b0:76d:b6ef:941a with SMTP id s28-20020a05620a081c00b0076db6ef941amr12096826qks.13.1693968545118; Tue, 05 Sep 2023 19:49:05 -0700 (PDT) Received: from hurd (dsl-153-125.b2b2c.ca. [66.158.153.125]) by smtp.gmail.com with ESMTPSA id c18-20020a05620a11b200b0076f206cf16fsm4578546qkk.89.2023.09.05.19.49.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 05 Sep 2023 19:49:04 -0700 (PDT) From: Maxim Cournoyer To: Katherine Cox-Buday Cc: Simon Tournier , Saku Laesvuori , Attila Lendvai , Liliana Marie Prikler , Andreas Enge , "Felix Lechner via Development of GNU Guix and the GNU Systemtdistribution." Subject: Re: How can we decrease the cognitive overhead for contributors? References: <20230827135726.y33t55w4cvq6zsvb@X-kone> <874jkift8v.fsf@gmail.com> <867cp4sj7k.fsf@gmail.com> <38242808-2f06-4674-3842-aea1a5378d05@gmail.com> Date: Tue, 05 Sep 2023 22:49:02 -0400 In-Reply-To: <38242808-2f06-4674-3842-aea1a5378d05@gmail.com> (Katherine Cox-Buday's message of "Tue, 5 Sep 2023 11:01:09 -0600") Message-ID: <87wmx4c8yp.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::72a; envelope-from=maxim.cournoyer@gmail.com; helo=mail-qk1-x72a.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: mx2.migadu.com X-Spam-Score: -6.17 X-Migadu-Queue-Id: 8954D3A004 X-Migadu-Spam-Score: -6.17 X-TUID: qXiK44ZH2do3 Hi Katherine, Katherine Cox-Buday writes: > On 9/5/23 10:01 AM, Simon Tournier wrote: > >> Well, somehow, I consider the commit message format similarly as coding >> style. We can discuss which one is better than the other when at the >> end it only reflects some artificial preferences and for the sake of any >> project one needs to be arbitrarily picked. Why not ChangeLog? > > The distinction I draw is that I can usually run a linter against a > coding style. > > I don't care very much what the standard for commit messages is other > than if it has an expectation of structure, I be able to run a tool to > tell me if it's wrong. > > In other words, the overhead isn't "I don't like this standard", it's > "I can't find a way to reliably adhere to the standard". 'git log' should provide ample examples. The format is not strict, and it doesn't matter overly as long as it conveys a summary of the changes accurately; it is meant for us humans. The format is described summarily in the GNU Standards document; to read it, you can run: guix shell standards info-reader -- info '(standards) ChangeLog' -- Thanks, Maxim