From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id MDplF2wH02YCFQAAqHPOHw:P1 (envelope-from ) for ; Sat, 31 Aug 2024 12:07:08 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id MDplF2wH02YCFQAAqHPOHw (envelope-from ) for ; Sat, 31 Aug 2024 14:07:08 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=interia.pl header.s=dk header.b=HcmDmgO8; 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=interia.pl ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1725106027; 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=hmQP5TsYfsnSFZQOkt/SlQplM/7HeRAzQxLxB9TCGHE=; b=A10wxngcaBplYglu1QMHcs60U5PAO7ljK5VlwghRa0931aDsgUFRudxwSaFz/NEw+73mjN 7c9Kya4SIcoFCcQKCOFJD9JVpXZQlwJiuDOxrOB5qTt/ISGmXLMyD8uaqc2eFQXC0275O7 hhSgFSCm6gOYooXBz/UiyYr+9r8Mahubstei1H8eJculuTW3CyBjaH+WKRF8WriXiZ28lj UmGh8VKYNUXWoHt4skXgkDTauX9PP60Bw5MxaMQjvjGY+BenRuZa/N0MQQEEnKyr3SRuUv RFszHYLJ+Z+PjTas1v/AuXvqZk9dr8dYk/UX6m3mFnOVFEOVL2gT0SNJG/FYBA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=interia.pl header.s=dk header.b=HcmDmgO8; 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=interia.pl ARC-Seal: i=1; s=key1; d=yhetil.org; t=1725106027; a=rsa-sha256; cv=none; b=u5h/ORJHcCXCBkaTX92aFLPZyAXMBcP6ma4vu3R0tU/tL0/qPwWcXubrqQhor8KqUd1eld 54ATHmA6n23TcajjvFZNE9wl31re+q1ksbHwjMJveUEZExxFCvpT86ixjnj23KVR5T+MrJ IPogM3MkTAoZII+9wi9SnjW2JPMs9pitLXbgQAWUyS/vzkGqS2v6LIybcMSgXi+zXZguvI 2dlxZPVf05tTjj3sAA4woWtl1egGier7BBJ/0PDlUYrkn4SULGYZwUWT18Hsj/t0wnxx9w sj/c0y9Cbbumr6bVZRId2MCr+1dmma87pI0b9ebCvIht7ef7nhDoh9JJJn6eWQ== 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 3424F6B807 for ; Sat, 31 Aug 2024 14:07:07 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1skMrz-00058e-E0; Sat, 31 Aug 2024 08:06:19 -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 1skMrw-00058I-U3 for guix-devel@gnu.org; Sat, 31 Aug 2024 08:06:17 -0400 Received: from smtpo49.interia.pl ([217.74.67.49]) by eggs.gnu.org with esmtps (TLS1.2:RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1skMru-000596-6q for guix-devel@gnu.org; Sat, 31 Aug 2024 08:06:16 -0400 Received: from localhost (89-64-60-39.dynamic.chello.pl [89.64.60.39]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by poczta.interia.pl (INTERIA.PL) with ESMTPSA; Sat, 31 Aug 2024 14:06:07 +0200 (CEST) Date: Sat, 31 Aug 2024 14:05:56 +0200 From: Jan Wielkiewicz To: Ekaitz Zarraga Cc: guix-devel@gnu.org Subject: Re: Simplify contribution by using user-friendly bug tracker and git interface Message-ID: <20240831140556.3e47df9f@interia.pl> In-Reply-To: <57b92ff9-6c6f-2c1b-6c3b-4c3d9daecce2@elenq.tech> References: <20240831003521.5c956363@interia.pl> <57b92ff9-6c6f-2c1b-6c3b-4c3d9daecce2@elenq.tech> X-Mailer: Claws Mail 4.3.0 (GTK 3.24.41; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-IPL-Priority-Group: 0-0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=interia.pl; s=dk; t=1725105968; bh=hmQP5TsYfsnSFZQOkt/SlQplM/7HeRAzQxLxB9TCGHE=; h=Date:From:To:Subject:Message-ID:MIME-Version:Content-Type; b=HcmDmgO8WHcjzgMcJ0XBP35iA//QWDXPbkBg+kqvBN7QKzG5n1menq8Uh2Ib4yeu/ r960vK11A5egyHLkBhxIA1nABYpFm0uYo781fAUM1nOJtrGqYaURUfVb218eUxfyD7 6p5ZgVoVsTtknIxtjLJXYyQCHNWhE8x2OFT0YbFw= Received-SPF: pass client-ip=217.74.67.49; envelope-from=tona_kosmicznego_smiecia@interia.pl; helo=smtpo49.interia.pl 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_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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-Spam-Score: -9.14 X-Migadu-Queue-Id: 3424F6B807 X-Migadu-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -9.14 X-TUID: M7TOlMZ575P7 Hello again, On Sat, 31 Aug 2024 01:45:04 +0200 Ekaitz Zarraga wrote: > Hi Jan, > > > First, there are tags in the issue system: > > https://issues.guix.gnu.org/search?query=tag%3Aeasy > Missed this completely. Where is this documented? > > The issue of friendliness has been brought up in the past, I suggest > you to search in the mailing list for previous interactions in the > topic. > > In fact, I took part on a discussion about more general topics and I > mentioned we should be more empathetic with other people's needs: > https://lists.gnu.org/archive/html/guix-devel/2023-09/msg00488.html > Okay, will read this later. > > Tedious and counterintuitive are very loaded words, and not very > objective either. The intuitiveness of things is based on the > previous context people has. This is a GNU project, and the context > for many GNU developers is autotools, mail based workflow and so on: > maybe for GNU developers that's the most intuitive thing. Who should > we please? > I used these words because they convey my feelings related to the current process. The discoverability of the system is low - every time I send patches I need to reread documentation to then finding out my email provider does not cooperate (failing SMTP, having to re-enable email client support to proceed). So I probably need to change my email provider in order to contribute to Guix smoothly. I'm aware this is a GNU project, I'm a free software enthusiast and GNU/Linux user myself, but I'm not an epic GNU hacker and you can't expect all contributors (who simply want to update a package they use) to be epic GNU hackers. > In my case, I find the Github-like PR based approach quite > counterintuitive, but I got used to it before collaborating in Guix > and now I don't dislike it. Starting using PRs for everything made me > a little bit reluctant to try the email based approach. Surprisingly, > it happens to be way easier than it looks, and it's actually quite > cool. > Wasn't easy to learn it at first, but running "git push origin" to update a remote branch linked to a PR is pretty straight-forward. > You should give it a go: https://git-send-email.io/ > (If you don't like or you can't use that, you can paste the patches > in an email, or send them as attachments, which is as difficult as > taking part in this mailing list.) I have this installed and use it, can't send patches to Guix otherwise... > Once you use it for as long as you used other options, I'd love to > have this conversation with you again (I'm not saying you'd change > your mind, but the conversation would be fairer). > > I will share some thought here that I know many people in the > community doesn't agree with (and I'm kind of a 50-50 on it) but I > think it's worth sharing: > > > So, it is true that making the access to things harder than the > possible minimum is simply stupid. There's no discussion there. > That being said, it would be very sad if a seasoned software > developer, who proved to be able to write code for a complex project > like Guix, is not able, is discouraged to, or is afraid of sending > the patches via email (but is ok opening an account, making a fork, > making a pr and so on). I'm apparently smart enough to install Guix as my daily driver distro, learn Emacs with Paredit and hack together packages, and then an email-based system filters me out... > Putting it in a different way: not every contribution is worth > attention. If people who want to contribute are not able to send an > email, I don't think their potential contributions would be that > interesting or worthy. The skills needed to be able to participate in > Guix are quite advanced, I don't think the email is a burden for > people that have them. > So let's say, yes: we do migrate to codeberg.org. And now what? Do > you think the amount of contributions will skyrocket? Do you think > the amount of meaningful contributions will be higher? Guix is not one thing - updating packages is not the same kind of task as for example hacking on low-level system or package manager functionality. I believe simplifying or making contributions more similar to what other projects have would indeed help. One example would be a free software game project I take part in. The original founder of the game did not know git and maintained the game using GitHub's online editor. Then when he stepped down, we moved the project to Codeberg. In the very same project we also taught a literal Windows user how to use git and command line which then enabled him to make cool and meaningful contributions. And then I myself did several contributions to Guix while barely knowing what I'm doing. So I'd be careful with underestimating the power of inexperienced users. > I know what I say here might smell like some intellectual classism or > something, but if we slow down a little bit: implying that there's a > lot of people wanting to contribute to Guix and they cannot overcome > the burden of the tooling we use is a little bit condescending to > them. I'm doing my best to overcome the burden of tooling, but in the very same time I could just make my own channel with software I want updated on Codeberg, instead of contributing them to upstream Guix. > > *People are smart*. They'll figure out. Our process could be better, > specially the documentation for newcomers (which btw improved a lot > recently, and mumi is great), for sure, but, in summary: Yeah, the current format of the document makes it easy to overlook important things, for example there's no header called "Canceling Your Issue", "Updating Your Patch Series", etc. Codeberg's user interface makes these things discoverable under nice green/red buttons. > > - I don't dislike the PR style > - I doubt if using a PR based approach would result in more and > better contributions > - Just because something is more popular that the other thing it > doesn't mean the latter is less intuitive > - Our process is not more complex, but it might be *new* for people > - If we provide GOOD documentation, people will understand it > - We have communication channels (that work) for the cases when > people gets stuck > > > Those are my thoughts. In the end you could argue that it's my own fault for using a broken/incompetent email provider, but then it's the contribution system of Guix that exposed this issue as opposed to alternative systems like web GUIs that usually just work. Perhaps adding "your email provider may be broken, try using a different one" and "make sure to enable support for a standalone email clients in your email settings" to the documentation would help? I spent more time than needed in my life looking for solutions to fix email sending. So yeah, that's pretty much it -- Have a nice day Jan Wielkiewicz