From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id 2Da7CBNS92TlzQAA9RJhRA:P1 (envelope-from ) for ; Tue, 05 Sep 2023 18:06:43 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id 2Da7CBNS92TlzQAA9RJhRA (envelope-from ) for ; Tue, 05 Sep 2023 18:06:43 +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 004E562984 for ; Tue, 5 Sep 2023 18:06:43 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=V8HrKdHg; 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=1693930003; 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=e5BUj7GEZXJlLRqfVap78d0Fu6E6FFUqoMLgap+p8gs=; b=fEduLHFKStOMvHM3qO+5Tbs4k1J6Jr7o5Fb2zQVR+/DhFNb2hOMF+uqYGIF2+LAsbMrV4Z 3VguWo9CurWBAc5RIfXzQ3RJnPJzY0BMaMdOYh5ysDbtc1pZcOWI123mkv1HtrEI4c9a+q n/6zTjoT2Ge+tZH1AIvek7bC3i6OeQW/xFzoeBXlhhnWZ3FIdd5D9iK0sXIIFhK5W+CjXx mXIwB5HXhhNSiOtgRJJhLqqOnRq+YOBkZY/Sx8nfG6eghXtgWffWkibVY4NTrc/YQYCXDz J6ab7YgcYAXWL6Bd9duo8F9HK6dyms/9/XvWwkFBzueUS2/Jc1pz0gOHmrrbkA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=V8HrKdHg; 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-Seal: i=1; s=key1; d=yhetil.org; t=1693930003; a=rsa-sha256; cv=none; b=mw1+RkUWxTIYVgfBsycuC/g2kw2O0xhPSlB2EV/IUZPrZ3Cvo7/II4VYIeJey1+J1g86dI xEQDJxedvp9rzJK5r84eZI1gDFe3Lh1zazFEjLPsULxheCiu1X9+7zkzG8icgYfYmYWoKp vVM5gYBR6xoKW8OSbvsln19yrRihUD8539sbSnOGZ9QN8li8KEJSfm1WYOzg9ihbXjNS15 xdj2ZgQeF8Mu8MPuXh1q8P0ZFWBHo8N8YSpA0hx6MN1bGjZZYZUiFrYNNyjp+aJu3Xuzsf 5IGbg2RaklcRRanZA+RJWwi1kawL8/9dGJc8SuUp8Y9gwjADiYRTLsZDjWM4jA== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qdYZT-0004J4-Uj; Tue, 05 Sep 2023 12:06:31 -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 1qdYZS-0004Ic-60 for guix-devel@gnu.org; Tue, 05 Sep 2023 12:06:30 -0400 Received: from mail-wm1-x335.google.com ([2a00:1450:4864:20::335]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qdYZD-0002i7-5P for guix-devel@gnu.org; Tue, 05 Sep 2023 12:06:29 -0400 Received: by mail-wm1-x335.google.com with SMTP id 5b1f17b1804b1-400e8ab9325so7421455e9.1 for ; Tue, 05 Sep 2023 09:06:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1693929970; x=1694534770; darn=gnu.org; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:from:to:cc:subject:date:message-id :reply-to; bh=e5BUj7GEZXJlLRqfVap78d0Fu6E6FFUqoMLgap+p8gs=; b=V8HrKdHgRHHkw5b/yhsgB/61/AHwN1zyzZtHjr7Tr48wFf60Z+AykWoYtZ2QACSieo C2rzwnnJj+1al7S0Upc10+3LFwfFhcCn/0K9Cd5Wg4D630br2Kg/Xx9LEmR2po0rOlFz xPvmXC3pq+IwiVy5zL7PAgPcYlc3WTdPZsi4E4QNkuL6KQNnc8U/ivuPf8HtTTkniQcG lGikHiZsieAQBq+wQASZ/nIuee8nNHV/2vdEGttPv7HH1gb7XpmHE8kJSTi2wh19WdkT t5WloNdlhECseMu+1rOHOJhxCXrK5I0uMYy00yPjs3XeNKjgMhHNSv/LHAOlKqeMdJqz oPAQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1693929970; x=1694534770; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=e5BUj7GEZXJlLRqfVap78d0Fu6E6FFUqoMLgap+p8gs=; b=chNmy5Yznr5wRgTq8cfj01SBS3ulrmMQiMljXaM64yhpQ3WVW/zm84WRu/H43JJwjd CIeOHa4uprnK1YMaqMzXo/YEf7CMYFWPNzwr+8hXcpO9luuWUFs5nQgvMKNUK/1aLgjz y/6rBXK17mYEQm3yN2k4JaeHYFYNcq0mAWonrcg+LlQ0Jp1IGd/asIJPMPPW2sgmgUsa ENb4zGHAH1/uxFGZiiDutAHHQ1jkuuvZkf7yoB1I+vM+NfrlqNVfZlmGvrRSfwmJ4rr2 OJMoN0FvZp2kV3e8iXHOfkbpPiMvnpbmoc5QCa4Ou8A+0xeZaFRTEEdYp5AcLyytVNcf 4Etg== X-Gm-Message-State: AOJu0YxWHUWpNMJJ/dI3Ka6BYktqDDLMFc1OFvtIitzvJ8kPI15RtJD7 Zi0KR9hZs8moOieLTSjqLcA= X-Google-Smtp-Source: AGHT+IGeRWZysvtRLYIb6IzGgU5yVD1Eh31C4neEnYqPcSoD7meZES1rIoJLqcCSstW6GcKoaUDviQ== X-Received: by 2002:a05:600c:354e:b0:401:d8a4:17b0 with SMTP id i14-20020a05600c354e00b00401d8a417b0mr10702971wmq.2.1693929970117; Tue, 05 Sep 2023 09:06:10 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id k16-20020a05600c0b5000b003feeb082a9fsm17312557wmr.3.2023.09.05.09.06.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 05 Sep 2023 09:06:09 -0700 (PDT) From: Simon Tournier To: Maxim Cournoyer , Saku Laesvuori Cc: Attila Lendvai , Liliana Marie Prikler , Andreas Enge , Felix "Lechner via Development of GNU Guix and the GNU Systemtdistribution." , Katherine Cox-Buday Subject: Re: How can we decrease the cognitive overhead for contributors? In-Reply-To: <874jkift8v.fsf@gmail.com> References: <20230827135726.y33t55w4cvq6zsvb@X-kone> <874jkift8v.fsf@gmail.com> Date: Tue, 05 Sep 2023 18:01:03 +0200 Message-ID: <867cp4sj7k.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a00:1450:4864:20::335; envelope-from=zimon.toutoune@gmail.com; helo=mail-wm1-x335.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-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Queue-Id: 004E562984 X-Migadu-Scanner: mx1.migadu.com X-Migadu-Spam-Score: -7.07 X-Spam-Score: -7.07 X-TUID: +XroZppfvPjW Hi, On Mon, 28 Aug 2023 at 23:00, Maxim Cournoyer w= rote: >> If someone has use cases for the ChangeLog commits, I'd like to hear >> them. Maybe there is something that can't be achieved with git history >> without ChangeLogs, but I can't think of anything. Someone mentioned >> grepping the git log with them, but I think the same thing can be done >> with git log and git blame regardless of the commit message format. > > I used to think the same about ChangeLogs style commit messages, but I > have to admit that it forces some discipline on me by having me review > my changes in details and write out what I did. It'll sometimes expose > something that'd be better kept in a separate commit, or something I did > and forgot about in the early development, that should be dropped. > > There's also no stopping you adding a more conventional rationale as a > paragraph between the topic and the ChangeLog content (which should > appear at the bottom of the commit message). I agree with Maxim. :-) At first, I found weird the ChangeLog commit format and now it forces some discipline on me that I find that beneficial. 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? Even, it is that format (discipline) which makes =E2=80=9Cgit log=E2=80=9D = efficient, IMHO. As an exercise, try to find the last 5 commits modifying the procedure =E2=80=99haskell-build=E2=80=99, $ git log --format=3D"%h %s" --grep=3Dhaskell-build -5 2c0537d374 gnu: idris: Adapt to changed haskell-build-system. dc3e22f4d5 build: haskell-build-system: Build static executables by= default. 4bb40b098d build-system: haskell: Drop default "static" output. 9262c14d73 build: haskell-build-system: Remove unused linker flags. 39c97cf3d0 build: haskell-build-system: Process all transitive depe= ndencies. Cheers, simon