From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id AJeINf+U3WHTDgEAgWs5BA (envelope-from ) for ; Tue, 11 Jan 2022 15:32:31 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id mCQlMv+U3WFgVwAAauVa8A (envelope-from ) for ; Tue, 11 Jan 2022 15:32:31 +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 7A00321511 for ; Tue, 11 Jan 2022 15:32:31 +0100 (CET) Received: from localhost ([::1]:52464 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n7ICL-0002og-Lv for larch@yhetil.org; Tue, 11 Jan 2022 09:32:29 -0500 Received: from eggs.gnu.org ([209.51.188.92]:60822) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7HMA-00065d-Ml for guix-devel@gnu.org; Tue, 11 Jan 2022 08:38:34 -0500 Received: from sender4-op-o14.zoho.com ([136.143.188.14]:17424) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7HM6-0003bA-4s for guix-devel@gnu.org; Tue, 11 Jan 2022 08:38:34 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1641908305; cv=none; d=zohomail.com; s=zohoarc; b=Vzgr/7xPdDZ5rBG4T54l/5732hr54E84JPUIwoW+wOzY4WMdDsvLanQgw6C1AXyVGRcH9D64rkK80/7ABB0zwRMCFH496gSRuMlvCWf+Ok/pStRUdgvb4AZEYqfCfPlwYoJc/IWaB1TBCqjrk6PH4zjMkhN1dSOZmqdXIm/9vtw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1641908305; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=YK4hGEPhotPR0jPI1HcfrMR51aqbONjslQJQWLVLYkU=; b=WOZau0tin0XGkmI/tIpPqZDw+1ko1IUUl1LlzhQCZq9Rpm3rwE0ROjs0UyrycK64E0EtThilPkIlzpPccKeLnt/oLwgCsVwxuVAAqXgrsXHeJqf50f+SaVhcBv4AjE+lBENwS0+hyCHn2DRVPeuIyet8/aa3mNkNqtYeSatPxT4= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=excalamus.com; spf=pass smtp.mailfrom=matt@excalamus.com; dmarc=pass header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1641908305; s=zmail; d=excalamus.com; i=matt@excalamus.com; h=Date:From:To:Cc:Message-ID:In-Reply-To:References:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding; bh=YK4hGEPhotPR0jPI1HcfrMR51aqbONjslQJQWLVLYkU=; b=QSQ6t8B60yJyv4uq1Me9SmtUUrHSX1mMzezlA2ysBdDK5NUuSWUHjOyoF3ZKC+Q2 s3sydbIjlVRUXHZsBm0ydb18Xbeud5premMcOjRoPUzGC9jlVcTVaz6fDw+mseWm5Bj eY2jXJqc2qrq/GwXiPq9dIB+AA7e4TvxSDxiPV5E= Received: from mail.zoho.com by mx.zohomail.com with SMTP id 1641908302221538.3548643109596; Tue, 11 Jan 2022 05:38:22 -0800 (PST) Date: Tue, 11 Jan 2022 08:38:22 -0500 From: Matt To: "zimoun" Message-ID: <17e495c7170.d98f8848260163.7044546137218098180@excalamus.com> In-Reply-To: References: <87k0faa27i.fsf@elephly.net> <17e3a8189d5.bf62342823554.2534240434231206600@excalamus.com> Subject: Re: Planet of Guix-related posts? MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit Importance: Medium User-Agent: Zoho Mail X-Mailer: Zoho Mail Received-SPF: pass client-ip=136.143.188.14; envelope-from=matt@excalamus.com; helo=sender4-op-o14.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 , 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=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1641911551; 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=YK4hGEPhotPR0jPI1HcfrMR51aqbONjslQJQWLVLYkU=; b=Rfs/U4aA410XKceUQw7eLAHGnavTLGQW2tEkcauDsW84ijbM/VUAknaE6XpR7S+Sz/CBM3 mY3ZEAjILzLLJcG23x5+r6X6K6+4BJ4XtGn27/9Zl+FPCbxOknuzrecZy4JEQsHaulpTSx rfXfjk5MShW22YDl/8oxSV+LOXJvPT/RYBkbvoO9ynMl5IIOU0Bliqe7u0Oe4CRa8NbVz+ IU5AdNnlBYbsYTfDcnE3ya+bPX1DRSgdShEpkQQhFc968HsJtcwEhVOGocv6mewFNxskgs kC46obyjMCyWrYtYA1xQ7/Hbqqp1EGh1JuUkrD1uMtjy4A3bEWDJGtrGUltTyg== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1641911551; a=rsa-sha256; cv=fail; b=XeQi8kz/xlhbVpktmK9Jw5gSK9pcgiunbhbLFbuudwSFBYzJKT9cYbHHAYb4EquK3ISYX/ doMnOxTGH8kzaXcxZTWoBG8M1GCsPZU7Hd0/p1NFXC41e8p+aSOu/rxZiswlsu0RLAbf// Ob9xJFZJjRL/sRv0HyJ6J42SVJmQBIDwqcpudM2lZbU0+0KFi+Tg1r/YfmzugCkO4D5fiy lAORfIrMDppIaxr3F1gjePKGKEAt93s/akWwU4zyM6j93XbNvvdbt3RWJi55Zyps3cqbIU RlwZnI+hMKYlemjyD2ruYtak4woW+MINvjmMCvy5dETdokFHqfuuAkP3UJ2Ysw== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=excalamus.com header.s=zmail header.b=QSQ6t8B6; 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: -0.90 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=excalamus.com header.s=zmail header.b=QSQ6t8B6; 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: 7A00321511 X-Spam-Score: -0.90 X-Migadu-Scanner: scn0.migadu.com X-TUID: BtC62h23/Vlg > 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. +1 Documentation is fundamentally about teaching. Having different avenues is needed to help structure learning. I think using Emacs as a model here is a great idea.