From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.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 uKDcLkQ56mRH/gAAG6o9tA:P1 (envelope-from ) for ; Sat, 26 Aug 2023 19:41:24 +0200 Received: from aspmx1.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id uKDcLkQ56mRH/gAAG6o9tA (envelope-from ) for ; Sat, 26 Aug 2023 19:41:24 +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 9B7BA38632 for ; Sat, 26 Aug 2023 19:41:24 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=VSZ0NGfL; 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=reject) header.from=disroot.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693071684; 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=q/UMgkcgz80gIESpROCLo1VvWcoZUtIbocFBZp3ZPU8=; b=ZCrzAZlEOHInHybCHqbh5z6gXe9Q8gqlvSK/inJW8w5Ex0tH7aXd/0zFXkDkbC6sYaSoXo GRSV5Go5cLfXpXqwal+1YNiFoLxh+5SEXa4tWBTYI3odDX5UZ8eStRxIGIJFM2vB0IFwOR hMduydxZruerrXKRDSfiFe9xLMf4IPEmVGm0Lvn+fJ7TMC8xTV0Sjo8JueGHYIgOEDHv/W 9b9/oGMRkYjWQnBSRP7hMxyaPifATVw+eTPSE/iAQOBUh/3/5IEz9L5G3/uWJyy6BWIjZk N+18E5W7jgrglsyMS6A7W0KeXC08V8oBO29huvpVqDk21omWdqbWwgV+LYJicA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=VSZ0NGfL; 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=reject) header.from=disroot.org ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693071684; a=rsa-sha256; cv=none; b=SJMr8jjSypezuLcRoAD4DWJ+ixHhlFghoiEBQnfJ31dT2pC5qJ+LrMBbsuBQfYBoYPL518 kHZeXRU3oO1EkqB3soOfKi7oeI+8f3mAtX/MlcWmdhXqO5bp3sjGim96TxHFS6UWDaV1fK U5EKNd4J7LhMgUYgI4lviHBnCGDn8tudjOM5nQmGfj/+cELvIWJoySSTasFGVlntp8QGDT MezC2YybHuz6V0N3eTam3/5PzCrMpnUg0zNyQYj+bGEymbs5iBU5zNWe/4FydQg7jdFvC+ Iyo6NooyR5g0Isu+4O2lkTWxd4tndtMQjSFOGtb1PRHBMgmrg/TNKLFw9/K9nw== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qZxH9-0003Do-6o; Sat, 26 Aug 2023 13:40:43 -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 1qZxH7-0003Cp-A9 for guix-devel@gnu.org; Sat, 26 Aug 2023 13:40:41 -0400 Received: from layka.disroot.org ([178.21.23.139]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qZxH3-0000qC-UN for guix-devel@gnu.org; Sat, 26 Aug 2023 13:40:41 -0400 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 2305B40DE5; Sat, 26 Aug 2023 19:40:34 +0200 (CEST) X-Virus-Scanned: SPAM Filter at disroot.org Received: from layka.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id LzFNgtCLyTXG; Sat, 26 Aug 2023 19:40:33 +0200 (CEST) MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1693071633; bh=BmP4/ACOJN/TaSESff2HlZl1zlrMO6d978lilr9zcsk=; h=Date:From:To:Cc:Subject:In-Reply-To:References; b=VSZ0NGfLK6uki1F+3h20RuIJjesDUV5AhTpFjLG8htR5BtjkOn8ZThyhf/I2z4v4N geC1tU3mHdoCwJC2FlfqWmyXx3DXc1WWNeO/tmTDlKTFYRDqZzFMpAiol6WrBcmEnd FjurzE4ja1TO2/+1VUr06u4agluc5s1hhuKWdJF9IGm571+XfZI4VlnucZ6DudS74K n+tUv4gNLm9atuPZeZWn/kyxgZ4Blh2Fl8ZhCitc+OfhfW2Ax+xmtws3qRxYcOWkco OGGyEaBvbWWhSwYlTFVdes5emSXE7eczHz4XiZJx+rzw4KOC3tv6jD2GW8f1NVaLDa Y+r/BoKQOwFWQ== Date: Sat, 26 Aug 2023 19:40:33 +0200 From: kiasoc5@disroot.org To: "(" Cc: Katherine Cox-Buday , guix-devel@gnu.org Subject: Re: How can we decrease the cognitive overhead for contributors? In-Reply-To: <87msyhgccg.fsf@disroot.org> References: <87msyhgccg.fsf@disroot.org> Message-ID: <69b2359eb3553d0784e9e62cbd6dfd30@disroot.org> X-Sender: kiasoc5@disroot.org Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=178.21.23.139; envelope-from=kiasoc5@disroot.org; helo=layka.disroot.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: , 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-Migadu-Spam-Score: -8.56 X-Spam-Score: -8.56 X-Migadu-Queue-Id: 9B7BA38632 X-TUID: JrbrIq3x/f6b On 2023-08-24 08:33, ( wrote: > Katherine Cox-Buday writes: > >>     I can't ever seem to get the GNU style commit messages correct. I >> use the >>     templates provided, but those don't cover all cases, and I've even >> gotten >>     feedback in a review to change a message it created. > > You do get used to it, but the format is very... verbose, and > personally > I think we should abandon it; the signal:noise ratio isn't good, and I > don't think the automatic generation of ChangeLog files is a great idea > anyway, since so many changes to Guix are so trivial. I agree with this, the commit messages could be made less verbose. One way is to go from this: gnu: PACKAGE: Update to VERSION. * gnu/packages/SCM.scm (PACKAGE): Update to VERSON. to this: Update PACKAGE to VERSION. Because I already know that the package was updated, and it doesn't matter which .scm file it's in unless the package is moving to a different module. I do like the GNU style for changes to packaging style (eg inputs/phases) but many package upgrades are just simple version bumps. > I think we should just use the news file more often instead. Yes. For example, where's the news for the recent KDE system service, or the recent Texlive reorganization? (great work from all involved!)