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 JskuJAt+92Rb1wAA9RJhRA:P1 (envelope-from ) for ; Tue, 05 Sep 2023 21:14:19 +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 JskuJAt+92Rb1wAA9RJhRA (envelope-from ) for ; Tue, 05 Sep 2023 21:14:19 +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 3A03844778 for ; Tue, 5 Sep 2023 21:14:19 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=CyafXRax; 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=riseup.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693941259; 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=58APCL9CpCR0v6rDd8ZTyTuV2191NUq8LyPU0MASaqo=; b=tFWnShQYPhJ8KFR46XVxJv/e97FRCxLLp7HHT8MmzLh+98UTvNuj9d/mZ259oTfswNNpYq NMbKrKRAOzzpeuno06dIoe+0eupmYYABWI23yoR83Re5bEMX74L6CG4DG3O5EdY7E+FWoH VTOBVC6TlqM5NIfFHU4LZLXwjuvZXUMqCaob0DlAspiH7yanRg9Utr37aG6h9WaSC/1hdV lKnlYf/kgbMURqFGYe4CG5I1pVY714gzGgbj3Pt3AHnvknk2m+WWunMAPvxYUetXjIj1zF 2UaQ7mSe1x5HA+7KRgQzkoaz/Aif02xXsTvpTP/Nw7Eb4mbxK3Uk+kbiFi3AkA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=CyafXRax; 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=riseup.net ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693941259; a=rsa-sha256; cv=none; b=hJRPMdVMlgZSjsUY5dEdblB1kHJRPmS97PHdQW0sEupgCDN3N9GlgBdJ3iz4Mq3dhtAUng ahFviNXXpQHY8/1MrQauYoT+k4cPtZi/p5LDAtxplDvV25xFkQs6XP9YBi0oeEn5j6VnUN uCasofUcH4byFjejBikkCTBG8VuEQf6G4HOYQF2IjsEOknXcGiwvbLicV0ELqNxvVlZK1v MCTXq9J4X8sNP3qY5p/GrVCm4u41kAHT7zkdNG/QDe1xT/gqH9bS5FFrPsRCqdBVJTA8SA H3Tb4aMpdU34UZbsZ0El1GeyuMPl2SoUf5deD93dtyv0a2ZxqrfS+MhvNDVzfg== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qdbUY-0001zY-Ke; Tue, 05 Sep 2023 15:13:38 -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 1qdbUX-0001zJ-2S for guix-devel@gnu.org; Tue, 05 Sep 2023 15:13:37 -0400 Received: from mx0.riseup.net ([198.252.153.6]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qdbUU-0008G3-Nj for guix-devel@gnu.org; Tue, 05 Sep 2023 15:13:36 -0400 Received: from fews01-sea.riseup.net (fews01-sea-pn.riseup.net [10.0.1.109]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx0.riseup.net (Postfix) with ESMTPS id 4RgFXX5msXz9t7s; Tue, 5 Sep 2023 19:13:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1693941213; bh=UjHLtheXsSxkdvuusVqqxQPdu5YMD5MqMhkNaZxddVY=; h=References:From:To:Cc:Subject:Date:In-reply-to:From; b=CyafXRaxYMZfmuYc+fgPF0Qe3OhRJBIfjoZA5NGPcIktDXSIwNoIHcenvG0rBe6W5 /YaK3Gf9zNdzvLDYjHTE57DvcLPqFI8I1guRMIrCQ//emUynKBkz5vw4OWPwI8NEhi MTt0w77K/IVTRkjN0mOMGFEfEnHARP9CY8GKrJEM= X-Riseup-User-ID: 05AE18D3521038C110C290D85D3F9F89DACD916683D776AED52D8AF71E212CE9 Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews01-sea.riseup.net (Postfix) with ESMTPSA id 4RgFXW2z1xzJnCN; Tue, 5 Sep 2023 19:13:31 +0000 (UTC) References: <871qfsuvad.fsf@gmail.com> <8e74c4ac-a6f3-9127-7e13-593a2eb70432@gmail.com> <87a5ubqxm6.fsf@gmail.com> <877cp8965f.fsf@xelera.eu> <8eb1be08-4c3a-bd30-46c7-4ed653c4bb12@autistici.org> <87ledotmqc.fsf@riseup.net> <874jkads65.fsf@spork.org> <87wmx4rbzk.fsf@riseup.net> <877cp4iqnj.fsf@gmail.com> From: Csepp To: Maxim Cournoyer Cc: Csepp , Andreas Enge , brian , Attila Lendvai , paul , Giovanni Biscuolo , Katherine Cox-Buday , guix-devel@gnu.org Subject: Re: How can we decrease the cognitive overhead for contributors? Date: Tue, 05 Sep 2023 21:08:58 +0200 In-reply-to: <877cp4iqnj.fsf@gmail.com> Message-ID: <87pm2wqvqh.fsf@riseup.net> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=198.252.153.6; envelope-from=raingloom@riseup.net; helo=mx0.riseup.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-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: 3A03844778 X-Migadu-Scanner: mx1.migadu.com X-Migadu-Spam-Score: -4.34 X-Spam-Score: -4.34 X-TUID: COU8YvLL8vm6 Maxim Cournoyer writes: > Hi, > > Csepp writes: > > [...] > >>>> Regarding the GNU changelog commits, I really dislike them. They're >>>> redundant busy-work as far as I'm concerned. And while I'd like to say >>>> they're no longer necessary, because we have better tooling >>> >>> As said before, I use them all the time through >>> git log | grep "whatever I am looking for" >>> or the interactive >>> git log >>> then "/" for searching inside the less command; I find it useful to a point >>> that I have moved to this style for all my coding projects. >>> >>> So as far as I am concerned, they are tremendously useful. Well, that may >>> be due to a lack of git knowledge, of course! But while in other projects >>> I often find I need to look at the content of commits, in Guix it is often >>> enough to just look at the changelog. >>> >>> Andreas >> >> What's wrong with grepping the contents as well? > > It's like a 100 times slower, at least on my low spec machine. It's > also not as obvious (you search for lines added or removed or changed, > not easy language such as 'gnu: package-name: Add'). Hmm, that's a quite valid criticism. I haven't tried grepping commit contents on my netbook yet, but this suggests that it would be pretty slow. But some info is still redundant, like file names. Git already supports getting the history of a file, so file names might not be necessary in the log. I agree that important identifiers should still be mentioned, but I'm not sure if the current format is the best way to do that.