From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id YDWKMCMT3mHi7AAAgWs5BA (envelope-from ) for ; Wed, 12 Jan 2022 00:30:43 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id +KRDKSMT3mE9gQEAG6o9tA (envelope-from ) for ; Wed, 12 Jan 2022 00:30:43 +0100 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 32E2C30D1F for ; Wed, 12 Jan 2022 00:30:43 +0100 (CET) Received: from localhost ([::1]:43744 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n7QbC-0003ns-3g for larch@yhetil.org; Tue, 11 Jan 2022 18:30:42 -0500 Received: from eggs.gnu.org ([209.51.188.92]:57274) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7Qaw-0003nj-NQ for guix-devel@gnu.org; Tue, 11 Jan 2022 18:30:26 -0500 Received: from sender4-of-o51.zoho.com ([136.143.188.51]:21197) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7Qau-0005G5-CV for guix-devel@gnu.org; Tue, 11 Jan 2022 18:30:26 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1641943820; cv=none; d=zohomail.com; s=zohoarc; b=hFMyv/71AwxLRK3kMrj20X16PSaA48vr32u9IkHxXYrkr1NDOwySmhYyenNUZd7Sn/Dxnv2YZFw80v9uElJusS/pfM0N9fy/33Z50Iz8X0d5mFREORWlDMMgGPu8b/Uuekt3w7Ehcks1CXjSaALgpJi0HNcf+RRlRFC6uWYunAA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1641943820; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=Gy/XfqpaVz5B6LxrGJjC6w2T4GoB37R0KCxOatGHNME=; b=StlRkEuNaP5VxkveDn3o4fwsePOGjEQYbvuMQgPLszMGU3Ce52GZtOl3ciN5Amd1ML4+JW+z2IG6ad8ZdUzakJV4AfiWc1f9AW51DUd7LikX0XSIasyvn3n5K1SdY4h8Xi654yyF0gSXe+UCOR/BMjlpL/F/gQYlzNGUFu/ekNo= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=elephly.net; spf=pass smtp.mailfrom=rekado@elephly.net; dmarc=pass header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1641943820; s=zoho; d=elephly.net; i=rekado@elephly.net; h=References:From:To:Cc:Subject:Date:In-reply-to:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding; bh=Gy/XfqpaVz5B6LxrGJjC6w2T4GoB37R0KCxOatGHNME=; b=g0Jr5uAMMI9zOniEfq5ywKJYYR9jsN1rJRtLjM6zcNM7j9oZOKNVd6PiD5lUxOjF FG1y0gvEu0RsBzHyw/agvJTfkAQI3O6YUDkHUr6oTkfweSSd3Mn1Kf4iGqFw/xEII9w q9myx9B1V+vtO8fA5fDnl+UgQqaaGB3P0AZquZmY= Received: from localhost (p54ad4f71.dip0.t-ipconnect.de [84.173.79.113]) by mx.zohomail.com with SMTPS id 1641943818591299.91714165312; Tue, 11 Jan 2022 15:30:18 -0800 (PST) References: <17e40b111ce.bc05a4a071499.1598136714226569120@excalamus.com> <17e49565b21.1285153a6259042.8278566905195778367@excalamus.com> User-agent: mu4e 1.6.10; emacs 27.2 From: Ricardo Wurmus To: Attila Lendvai Subject: Re: Guix wiki Date: Wed, 12 Jan 2022 00:18:25 +0100 In-reply-to: X-URL: https://elephly.net X-PGP-Key: https://elephly.net/rekado.pubkey X-PGP-Fingerprint: BCA6 89B6 3655 3801 C3C6 2150 197A 5888 235F ACAC Message-ID: <87zgo16ebc.fsf@elephly.net> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-ZohoMailClient: External Received-SPF: pass client-ip=136.143.188.51; envelope-from=rekado@elephly.net; helo=sender4-of-o51.zoho.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, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, 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: , Cc: guix-devel@gnu.org Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1641943843; 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=Gy/XfqpaVz5B6LxrGJjC6w2T4GoB37R0KCxOatGHNME=; b=npMJ4zBwl4/Wykgiqtm2EB3GydvYPZW7qsubxzfPJseon2VYDloggSlhAxlP9uKaSrnEXB lpZObu/k5TVO8xrzP0gp12NNDZ9xkVH9AQZdmw9ClmzSBv2bbQ8WPgzhUTUTtGewVlyJUu 0Au+JhOkmR10pms4jMAtzWoe0GZBNyJWcPPe2FuxnD+kN1utehdATPjAvXx+uuDnS3iE9x 9drCWZfl1ZzCqIt8hNdZZJ/6zVrsEsWr2zS62FvjWOX5CMk1/FBxjZQaPg4jfJAyGotG9b LX/rx6BRNWQxYQF/HHI1hbOVqFZ8k21SjrA/e0HGfXPZDviOHZjhaHm/xohTXQ== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1641943843; a=rsa-sha256; cv=fail; b=m/qAvoMwSNvDtkZbaprBrkYn8+L27lvVq0pECb0BWkRJncdkjfepgwrQEIs68B9lTf5udL gxV1/JwxWRSuFfHcnsYsn/5CpfStDPAkQEfOj5bwB80cTwYiY5gD2GnzlhZjgfrwJdv0a2 MMtZGVRgd3k9Qp5Sxj8DIvRwSV59XMz0+utyOroJhJXEDrSmhqRzPVZv15N9cM7XQIYn2m 38+tv4u/FXUcdMklnVAYxREq9gncBKufxUUFpe9EyWIRsGGyRSJll1G7RnqHnlZX9sWsZ8 Txw2IdUI9wWnx0ElbikuJMWN0cNWSaSPbnAk+L1GOvB+/lxEbbwK5Cq1e6lhuQ== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=elephly.net header.s=zoho header.b=g0Jr5uAM; arc=reject ("signature check failed: fail, {[1] = sig:zohomail.com:reject}"); dmarc=none; 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" X-Migadu-Spam-Score: -1.12 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=elephly.net header.s=zoho header.b=g0Jr5uAM; arc=reject ("signature check failed: fail, {[1] = sig:zohomail.com:reject}"); dmarc=none; 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" X-Migadu-Queue-Id: 32E2C30D1F X-Spam-Score: -1.12 X-Migadu-Scanner: scn0.migadu.com X-TUID: or3i6RMfdeoI Attila Lendvai writes: > sending a patch to the manual is a way higher threshold than editing a > wiki, especially when it's someone's first contribution. and some > random, half-baked copy-paste doesn't belong in the manual, while it > may be very useful when found in a wiki using the search engine. This is where we disagree. I=E2=80=99ve wasted so much time in my life following outdated or wrong instructions on forums or wikis. I really don=E2=80=99t want to see anything half-baked anywhere near this project. = There are few things that frustrate me more than well-meaning but misleading advice. The cookbook can have little vignettes on how to do this or that =E2=80=94 a note on how to debug an error, how to configure a certain tool (if the way it=E2=80=99s done on Guix is special), etc =E2=80=94 there is no need t= o write full-blown tutorials, obviously. > also note that i'm programming since i was a child, 30+ years now. at > least half of it was part of opensource projects, and yet i had quite > a learning curve getting to the point of submitting patches with any > level of confidence (but not yet comfort). > > emails + debbugs + emacs + double-spaces + whatnot are all a cultural > thing, and not necessarily simple for aliens, not at all. if you want, > i can get into the details. I keep repeating myself: you don=E2=80=99t need to use debbugs. We do. No= r do you need to use Emacs. (I do.) You don=E2=80=99t need to use double spaci= ng, though someone is going to change it for you when applying your changes. The requirements to contribute to the cookbook or manual are simple: write text that is useful, correct, and readable, and have someone turn it into the expected format for you. If you=E2=80=99re a repeat contributor your mentor may likely ask you on your next contributions to make a few changes by yourself, so the learning curve is personalized. Before Guix I had never used Debbugs. I rarely ever contributed patches. I had no idea how to send patches via email. There was a time when I didn=E2=80=99t know that patches are generated with tools. No aspiring contributor needs to be fully formed before they are permitted to contribute. Get yourself a mentor within the project who can shepherd your contributions and make sure they find their way into the right files. Ping them if your contribution seems to have been forgotten. In my opinion, a public list of mentors that you can ask to charge of your contribution would be worth more than a mere info dumping site. --=20 Ricardo