From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.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 MKKDHSa992RcuQAAauVa8A:P1 (envelope-from ) for ; Wed, 06 Sep 2023 01:43:34 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id MKKDHSa992RcuQAAauVa8A (envelope-from ) for ; Wed, 06 Sep 2023 01:43:34 +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 8AD6A66E47 for ; Wed, 6 Sep 2023 01:43:33 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=spork.org header.s=dkim header.b=iSYwkCvE; 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=gnu.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693957414; h=from:from:sender:sender:reply-to: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=Z6FfGKVNQT4v9MhqqCKUU/mResRBcTIgsQ1fmujJoMw=; b=PobI2n883f4X+ltg2f17nsmfmugy/Gtw6415l+D4JsUj6yUfpTHdhEwlyhORk5aUyuVqL9 Mxa4ap8N2GIuPAW+KziFkMdOeUf/AUsHZLhOGOn4x9bEzlJsc2YDAnR8k3eZe6hg/wSaO+ vLLRRTmBbPhNHjarcAQI1c1wBGzCoaS6oulsNJ3G0j5GHr/glyipTGzp6CYC7v24lWbNCF XmbGBc7mE5GlvOevrFYrl8fjC3SXlqzy0J8BWmBPessuWJS/gsTj1Ty3WiNLIYS+a8iymM zu8sHdhl+T7D2KBoOsSosJAM6UHM5MBl/6qqVQj3W0PftkajVIk4AEkXAnsM/Q== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693957414; a=rsa-sha256; cv=none; b=m3kY3HzshBgkB33DkJLmxxc4xaSMfEGYFSlNvHWPjtg8cM7x3yJLZ893P7scj2ik1caCaE wE8bOz5M3Z6a9a86FtrfbS0wnVCN045POABSUdWDuqQjdqL8T+0TTJyvvT8mOkGXOsua5C n5bCMdE+AReDx50WwMvtTNMazCaHfVdeBJZnOdydQ5UcG3EfFdX+GkdEfDIWGokqvjDuSI RFinEZIwczKZfq+pqXyQKJMCHYMTAz+ZLGwU7kDEs5sfjkAIaNTjw9SBvRBxqaEWeVnXC5 PGU1Mj0+z/Rm8FIh6Q0H4JGB2qqSUDn53BvRhNIsgA/v50FY+/grUbWn3VTrsQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=spork.org header.s=dkim header.b=iSYwkCvE; 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=gnu.org Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qdfhG-0006w1-Ra; Tue, 05 Sep 2023 19:43:02 -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 1qdfhE-0006vb-QR for guix-devel@gnu.org; Tue, 05 Sep 2023 19:43:00 -0400 Received: from coleridge.kublai.com ([166.84.7.167] helo=mail.spork.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qdfhC-0002oS-LJ for guix-devel@gnu.org; Tue, 05 Sep 2023 19:43:00 -0400 Received: from ditto (ool-18b8e9e7.dyn.optonline.net [24.184.233.231]) by mail.spork.org (Postfix) with ESMTPSA id 32DA72EDC; Tue, 5 Sep 2023 19:41:35 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=spork.org; s=dkim; t=1693957347; bh=pQAhfbsISgERepWNdMP3emdbnk85K9AprTHVj33C9P4=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=iSYwkCvEUGiNVI/I1SHH/7l0E1KjJ3FHc0Ez3x6oCpWhIJYdDCONrvsgStJYyEAGL AGY1+ByiY80g4meDiVsddMPBk2oY+aAvZKA63m9vghXEFqGR9QLa7JS6LnedHsU3jK YKkc4RJAifjAcdGr/kGOCnEs9E4u1PFoBTFVRqHU= To: "(" Cc: Liliana Marie Prikler , Katherine Cox-Buday , Simon Tournier , Maxim Cournoyer , Saku Laesvuori , Attila Lendvai , Andreas Enge , guix-devel@gnu.org Subject: Re: How can we decrease the cognitive overhead for contributors? In-Reply-To: <87a5u0o3z2.fsf@disroot.org> (paren@disroot.org's message of "Tue, 05 Sep 2023 19:40:26 +0100") References: <20230827135726.y33t55w4cvq6zsvb@X-kone> <874jkift8v.fsf@gmail.com> <867cp4sj7k.fsf@gmail.com> <38242808-2f06-4674-3842-aea1a5378d05@gmail.com> <87a5u0o3z2.fsf@disroot.org> Date: Tue, 05 Sep 2023 19:41:34 -0400 Message-ID: <87sf7s9oi9.fsf@spork.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=166.84.7.167; envelope-from=bjc@spork.org; helo=mail.spork.org 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, 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: , Reply-to: brian From: brian via "Development of GNU Guix and the GNU System distribution." 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: -2.12 X-Spam-Score: -2.12 X-Migadu-Queue-Id: 8AD6A66E47 X-TUID: nTq0KWFiub/a "(" writes: > Liliana Marie Prikler writes: >> Uhm, we have snippets? > > Well, those are exclusive to Emacs :) And without regard to /that/ > issue, I do think that there's a problem if the commit format is so > complex that it's not trivial for anyone new to the project to write > them out manually. Even with the snippets, vc's functionality, and magit, not all cases are covered. Plus you have ti figure out how to use those tools for this, if you even know they can do it in the first place. It's a lot. On top of that, the documentation is lacking. The Guix manual refers you to the GNU documentation, which doesn't really cover our specific uses. I, like everyone else from what I can tell, just read existing log entries to try and figure out what to put in there. For the record, I don't really object to the header line format[1], it's the stuff under the commit message proper that gets me. All the =E2=80=98* foo/bar.scm new-package (inputs): add input=E2=80=99 stuff. I literally can never remember this format, no matter how many times I do it. I'm reasonably sure square brackes go in there some where. It can take me quite a while to put together all that stuff, even with magit's help. -bjc [1] I would like to see the =E2=80=98prefix:=E2=80=99 prefixes documented s= omewhere. If I'm not messing with packages and can just type =E2=80=98gnu:=E2=80=99, I h= ave no idea what to put in, and often even git logs don't help, so I just wing it.