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 +MUdJEJP3GG/RAEAgWs5BA (envelope-from ) for ; Mon, 10 Jan 2022 16:22:42 +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 iJr3HEJP3GFf5AAAG6o9tA (envelope-from ) for ; Mon, 10 Jan 2022 16:22:42 +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 2E05911EEF for ; Mon, 10 Jan 2022 16:22:42 +0100 (CET) Received: from localhost ([::1]:46244 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n6wVN-0005e1-BH for larch@yhetil.org; Mon, 10 Jan 2022 10:22:41 -0500 Received: from eggs.gnu.org ([209.51.188.92]:38616) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n6wUn-0005cc-NB for guix-devel@gnu.org; Mon, 10 Jan 2022 10:22:08 -0500 Received: from [2607:f8b0:4864:20::12f] (port=33410 helo=mail-il1-x12f.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n6wUl-0007Lk-Ub for guix-devel@gnu.org; Mon, 10 Jan 2022 10:22:05 -0500 Received: by mail-il1-x12f.google.com with SMTP id o20so5176437ill.0 for ; Mon, 10 Jan 2022 07:22:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=Egat3o6M9CW3HUZamgeBIYtuKPtIG0w8ZXDi8/eJjtU=; b=fcNfofCaKlSQrH07mLwR1RKMptpgB22rS66/VzF9Y9r5CrICMJa+H/u9mKjDqtC27z s1zoq/9/pSCTnNplyavd5ZQhrzO0TiOBdxWvXFQoowwea0gwuKzHJ/qjSzw8zd222xTZ eEIAd6U2l87Inn7stE5IhLcZZZdCIZC+XXv8TPY5BM7tisMuUi2z4qMhHHQDAYsBaedz ivQcMBuFQayTksrOC+/B7x8EGJhrnuOMNeYzESd4IcD29OekQR9lWeoSrJUVDMLIigUG w7u9Z9Ead59czDK/c+iFpCviE/AckAzIBY3hL9A9n1OFestGq0m0Y8rz6dJcyO7RYhq4 BmJQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=Egat3o6M9CW3HUZamgeBIYtuKPtIG0w8ZXDi8/eJjtU=; b=3aPHizpjyzpEd8r7rXNn+kVTLCGoOd2+k6KfdpoXr3Mj7A1BgmX4l9L36Ej9sRaovO J9O3OHBTFgr6PnJavT159a48Wm/IVjlK3U0MyLbs7SGfVBaEYtva5Q4C/KfE3fgbHg6o XlkiVjcmVieGg4JKgWketLe9m065gYcDPrP/jih3PAKRcyss557Pe9UhsaDaEx2nK1a3 b7QWsxFpc9kSmCOgSNF3XK8P0YV7MiXL5YbL0HgxoxHFFvl0MdF5fbiYWZEPYUg3/vsk YKtIDSZekuf+jCalI4zsH5VH0bKCB17lmmqYYHsA9A2/TXTibO07MbjBDGlsJgW5dgMo TUsw== X-Gm-Message-State: AOAM533e6sSAHiI/puX0UrohwBSQBM/EDEMiy70nltwqFBLjURmpnFm0 EZr7df0MvwFUetXHC5CleEftRrMthPxRNOtrgk4= X-Google-Smtp-Source: ABdhPJy57bXuW/AnZt+fTi4LJLNVxhdKIg+sGCOBwkOp7jqUamTXGbXqqi0n8KBvCj7K4JcDnIOSm2YcfSZ5dl9sGbc= X-Received: by 2002:a05:6e02:1bec:: with SMTP id y12mr20440ilv.233.1641828122807; Mon, 10 Jan 2022 07:22:02 -0800 (PST) MIME-Version: 1.0 References: <87k0faa27i.fsf@elephly.net> <17e3a8189d5.bf62342823554.2534240434231206600@excalamus.com> In-Reply-To: <17e3a8189d5.bf62342823554.2534240434231206600@excalamus.com> From: zimoun Date: Mon, 10 Jan 2022 16:21:51 +0100 Message-ID: Subject: Planet of Guix-related posts? To: Matt Content-Type: text/plain; charset="UTF-8" X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::12f (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::12f; envelope-from=zimon.toutoune@gmail.com; helo=mail-il1-x12f.google.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 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_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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 , calcium 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=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1641828162; 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:dkim-signature; bh=Egat3o6M9CW3HUZamgeBIYtuKPtIG0w8ZXDi8/eJjtU=; b=IGqeh1dGLTg8XwGZ9TtD17n2XtYA2vQAcnrWwifNJp6DY9NYFSmbJhJh15hS9wptaGRJry tovW8cFJCZpWRlwlpNaacrsA/uzZdmunT89wlWzk7VgB21YoC4Nd9CuF6WtXQcCia1aeSR 8bpGFT4SlmQxq9usPxC21PUnJhyO2UpK4XvbpjfG8Nt8eLvGgHXfahr86msruJuOtochtT RI+XBGmtEJr+kpIlYct4tqcj2K76wMTJlFvjXw9YPfn0Qgp55yKPvyb0Xi0U/lY5hmvs0U yTxPdaoYW2K0rgopAzK3kHwgt9vK1nE7JGNINbvPrRnVogZmaPlgaxksuYDCcA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1641828162; a=rsa-sha256; cv=none; b=ouR58upvUO1/endMwXSoqGLhrZhIjEaAYAt1P9JCni12yqk3u/Ugzq4sM0Y0tJVpbViTcD eDqhzawoAltMIw4X7+FQOz2V8K4K1e1iS14CwG2J2ba+GEswPSpb76XlLC2RscCKeBK0dP SzZPo5N2deWQD8O7Wk+P+8C0Rq9Hpm5CuyjhNR3B8GS26htgsEGbcPLtNwi76CHDLnlULI TR0RbLNiT7IH1Fel94GDpGO71RpVFjPr+QyyLqlpGIouKWRgAn28HS3Slz7HunabTv0bpP n63z3qwww8olIK7Egzzi8edNK39Sf1ono5Av2H6+KeeyYosK4XUhPuOkxgbtIg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=fcNfofCa; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=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.61 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=fcNfofCa; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=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: 2E05911EEF X-Spam-Score: -1.61 X-Migadu-Scanner: scn0.migadu.com X-TUID: FOvLijerNR/c Hi, My two points are: 1. we could have a Guix planet -- we should avoid the cathedral for quick recipes 2. too many different goals are directed to the Cookbook Well, my point is: instead of cathedral with an authority accepting patches after review, why not a web syndication (bazaar) as a Planet collecting various blogs. This would help to stay aware. For instance, I read, https://planet.haskell.org/ https://ocaml.org/community/planet/ https://planet.emacslife.com/ https://planet.scheme.org/ and many others and for Guix-related, basically, I use Ludo's toots as such Planet. Thanks Ludo. ;-) Bah, I do not know if many blogs about Guix are around and how frequently they would be updated. Similarly, some time ago, an "awesome list" had been started and now, quickly searching, I find 2: https://github.com/techenthusiastsorg/awesome-guix https://sr.ht/~lle-bout/awesome-guix/ Therefore, doing so... On Sat, 8 Jan 2022 at 17:25, Matt wrote: > I have two documents written in Org: > 1. http://excalamus.com/test-guix-case-study-plover-python-dictionary.html (On a side note between parenthesis, we should avoid to fall into the "Package Definition" tutorial fallacy; as explained here for monads https://byorgey.wordpress.com/2009/01/12/abstraction-intuition-and-the-monad-tutorial-fallacy/. And I wrote one post about monad and another about Packaging. ;-) However, I think the official documentation has enough materials for starting to package. End of parenthesis.) > 2. http://excalamus.com/2021-10-06-guix-debug.html ...it is possible to individually write using our preferred tools and managed our way. Moreover, for instance, times to times, I write entries to my "blog": https://simon.tournier.info/posts/ For example, this edited had been published before there . Therefore, maybe people not afraid to write to their own blog but afraid (or not knowing how to) to submit patches would provide material for the official blog post, who knows. :-) Last, we have to distinguish between "temporary" content and well-maintained documentation. We discussed many times the Cookbook and I think what we are trying with a limited success that this document fits too much goals at the same time. For instance, if I would have to send a patch for fixing Wikipedia typo or adding a quick paragraph about preconditioner of linear system, I would never just do one or the other. The Cookbook is currently too rigid for quick half-backed recipes. In my views, for what they are worth, I think the level of documentation should be: - manual as it is now - cookbook turned into a step by step comprehensive tutorial - wiki being a how-to-quickly-fix, similar to Arch wiki for instance We have Guix manual which is really great. We have Guile manual which is really great once you know what you want. What is missing in a document in the middle and something similar to a wiki where it is easy to edit and change. For what the analogy is worth, Emacs manual and Emacs Lisp manual are doing their job as manual. However, if one is new to programming, the document An Introduction to Programming in Emacs Lisp [1] is a great resource because it is in the middle, IMHO. The Cookbook should act similarly. Something as an official kind-of tutorial. 1: https://www.gnu.org/software/emacs/manual/eintr.html And somewhere an easy to edit half-maintained not-really reviewed wiki where anyone could provide their material. Cheers, simon