From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.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 yH2DMTF5CWWLoQAAauVa8A:P1 (envelope-from ) for ; Tue, 19 Sep 2023 12:34:25 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id yH2DMTF5CWWLoQAAauVa8A (envelope-from ) for ; Tue, 19 Sep 2023 12:34:25 +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 58B8D4CC15 for ; Tue, 19 Sep 2023 12:34:25 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=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"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1695119665; 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; bh=Uj2+1nfycwD5YHA7My3iVIjeh/XU5PjkkFEk1z5foMg=; b=Pvf37zgZ23rfYMWfHNBJghNkuFRCWe4xhZJUzRIdZpJYXI03mmxEykzqDhS8f4l1j6Hsa8 XT8nR6xx1IWqPNdQOygc24jVdlSkfognGXjEqsop+MEYFeujkhZdj9VO+2D2KaDN5ojkPN bVmvXdF5lf0C3g+5hp8ywJmKeSVcqunIAjOkvTnQRps0K8hKTRCZTUELdc7DZK8b8JifMP AjJPsGmO3qPmKkgtvW4IF1Iu4T1dOOqUsKiaR3o9ieag1Se3x2NAMzCSiVMvn6rnIPj6X1 5nKr1J4kUrrMmH5GOZsHai3Kto3LqovBm5uCZ70BSPFZ3o5qdQESbWrWE9R1Jw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=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"; dmarc=none ARC-Seal: i=1; s=key1; d=yhetil.org; t=1695119665; a=rsa-sha256; cv=none; b=R8GlXqe1Jb0vmYaT3TNHXo3IZPnztMJT3UZ0N9wZfHcGZxDYONcBPh8u5Fl4OeB8QY+g3k GSeoOliTufsavF8DoCEAPDhBL356wERhdvRb9QvuPFg7Z1pKmy3UkgMa6a4/NjBmys5FOM 8msQ60841K17vay39LoYjihPer6YGjdAuacdMG2mZ5J3XY5eAQwyIbw1Y319HzpYMkwyfi Y4/ac7mVghJTkVQVIp9q4JhcjNIPyMlPGJXBVe+8fYc/LFL8I3/sXxWWmA0W/h3VvcUsxX yMehHmsZvnNphi268Fg4nhrf+JNhOKZr3hMAMlHjdRbrzLz3/5fvF+u7Iq78qQ== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qiY3J-0001Dp-UT; Tue, 19 Sep 2023 06:33:57 -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 1qiY3G-000109-40 for guix-devel@gnu.org; Tue, 19 Sep 2023 06:33:55 -0400 Received: from ns13.heimat.it ([46.4.214.66]) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qiY3C-0002Zu-CP for guix-devel@gnu.org; Tue, 19 Sep 2023 06:33:52 -0400 Received: from localhost (ip6-localhost [127.0.0.1]) by ns13.heimat.it (Postfix) with ESMTP id 03E283007E0; Tue, 19 Sep 2023 10:33:48 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at ns13.heimat.it Received: from ns13.heimat.it ([127.0.0.1]) by localhost (ns13.heimat.it [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id fn4Wwh5ylRv1; Tue, 19 Sep 2023 10:33:46 +0000 (UTC) Received: from bourrache.mug.xelera.it (unknown [93.56.171.217]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by ns13.heimat.it (Postfix) with ESMTPSA id 014B330022E; Tue, 19 Sep 2023 10:33:45 +0000 (UTC) Received: from roquette.mug.biscuolo.net (roquette [10.38.2.14]) by bourrache.mug.xelera.it (Postfix) with SMTP id 8C2E829E82A4; Tue, 19 Sep 2023 12:33:45 +0200 (CEST) Received: (nullmailer pid 17438 invoked by uid 1000); Tue, 19 Sep 2023 10:33:45 -0000 From: Giovanni Biscuolo To: Simon Tournier Cc: guix-devel@gnu.org Subject: contribute with content in our official help pages? In-Reply-To: <87bkdzssgm.fsf@gmail.com> Organization: Xelera.eu References: <87msyhgccg.fsf@disroot.org> <547c097a-d805-9a55-11d9-b0434327f89d@gmail.com> <871qfpjhiz.fsf@gmail.com> <87a5udaq7q.fsf@envs.net> <87il8z9yw8.fsf@xelera.eu> <8c30655ca9905946fc718940700f2475@libre.brussels> <871qf2tg6u.fsf@fannys.me> <87cyymw046.fsf@gmail.com> <3ca200ef-98bc-4545-bc27-c1fb92dac04e@fannys.me> <87bkdzssgm.fsf@gmail.com> Date: Tue, 19 Sep 2023 12:33:44 +0200 Message-ID: <87pm2e4flj.fsf@xelera.eu> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Received-SPF: pass client-ip=46.4.214.66; envelope-from=g@xelera.eu; helo=ns13.heimat.it X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, 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-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Scanner: mx1.migadu.com X-Migadu-Spam-Score: -5.88 X-Spam-Score: -5.88 X-Migadu-Queue-Id: 58B8D4CC15 X-TUID: YqgL4eGIbKDw --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi Simon and all readers, I have some comments I cannot keep, just to try helping making this thread harder to follow, if possible :-D. Simon Tournier writes: [...] > For instance, Vim [1] or VSCode [2]. The frame is not =E2=80=9Cwhat we s= hould > do=E2=80=9D but =E2=80=9Clet me show you what I have=E2=80=9D, IMHO. Wel= l, you are free to > join the fun! :-) > [1] https://10years.guix.gnu.org/video/using-vim-for-guix-development/ [2] https://videos.univ-grenoble-alpes.fr/video/26660-cafe_guix_vscode_comm= e_outil_deditionmp4/ Thank you for the pointers, Simon, I already knew [1] since I have a look to 10years Guix from time to time but I missed [2]. Although I don't personally use that tools, I find that information useful when Someone=E2=84=A2 asks me how do Something=E2=84=A2 using tool XYZ with Guix= ... but I'm sure in 5 minutes I'll forget almost all, since I don't usualy use all XYZ tools. How can we decrease the effort needed by Someone=E2=84=A2 like me to find u= seful informations on "how to do X with/in Guix"? 1. The "quick and dirty" solution is to use a "smart" query in a web search engine: Example query "guix write packages using vim": https://duckduckgo.com/?q=3Dguix+write+packages+using+vim It's not very efficient since the searcher have to do some _hard_ work first to find a "smart" query and then to filter out what he really needs; last but not least to understand if that information is still relevant or someway outdated or not working for his use-case. I'd call this quite a high cognitive overhead. 2. Search one of our _official_ "Guix - Help" resources: https://guix.gnu.org/en/help/ As you can see, We=E2=84=A2 have plenty of them, in (my personal) reverse o= rder of information discoverability efficacy (cognitive overhead?): - IRC (logs): http://logs.guix.gnu.org/guix/ - mailing lists, see: https://guix.gnu.org/en/contact/ - videos: https://guix.gnu.org/en/videos/ - wiki: https://libreplanet.org/wiki/Group:Guix - GNU manuals: https://gnu.org/manual - Cookbook: https://guix.gnu.org/cookbook/ - GNU Guix Manual 1.4.0: https://guix.gnu.org/manual/en - GNU Guix Manual (Latest): https://guix.gnu.org/manual/devel/ Someone=E2=84=A2 could help integrating useful information in one of the ab= ove listed resources, for example informations like [1] and [2] should go to "videos". Each of the above listed help channels have very different contribution workflows, ranging from chatting on IRC to sending a patch to include Something=E2=84=A2 in the cookbook or in the manual; this means that the mo= re Someone=E2=84=A2 would like that information to traverse that list "upward"= , the more will be the effort for Someone=E2=84=A2 (Else=E2=84=A2?) to add it... It's a path and it's /also/ fractally recursive! :-D For example, I have a feeling that many useful informations discussed in this thread have been shared in previous messages on this mailing list or IRC, wiki, videos... probably Someone=E2=84=A2 shoud find a way to integ= rate them /at least/ as a blog post in https://guix.gnu.org/en/blog/, if Someone=E2=84=A2 (Else=E2=84=A2?) find it would be helpful in reducing the = overhead to do XYZ with/for Guix due to hard discoverability of that piece of useful information; sometimes that piece of information is also /very/ useful in reducing the cognitive overhead for contributors, that's recursivity (=C2=A9 Simon Tournier). To be cristal clear: I find that also "externally managed assets" - a blog post, a video, a tool specifically designed for "Guix integration" of tool XYZ, a Guix channel - **are** useful _contributions_, but that kind of contributions are even harder to find and/or use if not properly "integrated in Guix". Happy hacking! Gio' =2D-=20 Giovanni Biscuolo Xelera IT Infrastructures --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJABAEBCgAqFiEERcxjuFJYydVfNLI5030Op87MORIFAmUJeQgMHGdAeGVsZXJh LmV1AAoJENN9DqfOzDkS874QAItxuidBJry7t1FcN6OfHPhl3xMpqeg4mBlxySaI lKaZJCo30E6YM0ftzAp7CF0aGwY8IpSCO2r+GAWYSMS16qJ0Sh6GmW1iPhD5J/WN Zk7sjbh+gnuF4hh3HhjoNaCSDa+5LHTHkF8IhaKtp53mK/vRz9Dk9AcEOu5gDOwH KHTrdxOn4+DvYULfxGp475yooJOB3vOk1X7j2LvQNjTBeJ9PeHcOjweVuOq/0Uka IVwlVTdpThVCeXfaD53GVrBa1h8bqvAi902gv33rpAet/hRmRUidpURuU7AEm0LL jdxaW5Ur3kNpG0v0nI11ieaLNqjdsTCnmB8NoqTxOt7nBvpdGkERdi96G+zw+HlO fkUx85V0QTeEPLHP9Ss+UoafQYeaANZKUUbDcWnwV2QTUAnssxom/MFXm7kfmvkV c963nFQoUO9QmuXlxw6aMW7BKDqg5/SIZRe+xO5TyV4USfUFWxYUK1G+QUX7vZmG 3gc4OHqf99OOeEUyShYYpbJdSOzC3JD7Qss2RKVPKDHKctLkt2PBE//WadRwXj1q bUjs3K7d87Jk19868ujOAUl93Gxg6HYRjcIfvLB8MRUBn8KF+44bNOh4wg51iylx 3gWIC2S6u4fuJjaIBo0kK3yzgGKJqN48JN47svae3pxa7sWu7+v7ttq7cYtNw8bT g5DY =wM1K -----END PGP SIGNATURE----- --=-=-=--