From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Neil Jerram Newsgroups: gmane.lisp.guile.devel Subject: Re: a cookbook Date: Wed, 16 Feb 2022 09:54:09 +0000 Message-ID: References: <87wnhx9yc2.fsf@vijaymarupudi.com> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="2560"; mail-complaints-to="usenet@ciao.gmane.io" Cc: guile-devel , Vijay Marupudi To: Catonano Original-X-From: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Wed Feb 16 10:58:21 2022 Return-path: Envelope-to: guile-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nKH4n-0000RX-0T for guile-devel@m.gmane-mx.org; Wed, 16 Feb 2022 10:58:21 +0100 Original-Received: from localhost ([::1]:34170 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nKH4l-0004kj-RC for guile-devel@m.gmane-mx.org; Wed, 16 Feb 2022 04:58:19 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:36692) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nKH14-0006EN-UL for guile-devel@gnu.org; Wed, 16 Feb 2022 04:54:31 -0500 Original-Received: from [2607:f8b0:4864:20::232] (port=45716 helo=mail-oi1-x232.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nKH0z-0006jF-1i for guile-devel@gnu.org; Wed, 16 Feb 2022 04:54:27 -0500 Original-Received: by mail-oi1-x232.google.com with SMTP id 13so1809788oiz.12 for ; Wed, 16 Feb 2022 01:54:21 -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:content-transfer-encoding; bh=ruRfOYYRC+bqd80PrjHq4xcpVS6nhlqCW49Ofp7w16k=; b=Jv7lf3kZYbAHE0TDs1zW8lRKZnfd/25cfwr/C6mU3mus+cydOLYsreamcP8RlAZ4Xu pDQtNjRztgr0NCg7abctv6wFSTPCi0wM2nEZ4TpvcElCUgC2ptvkb2KzGjUZhcXS42zO ALvI0lBd6/7V5ZixzeDyxpRQRDpDxSEJy2++JX8s40OXam7epHe7is6NXHLqU/ryX4cH oiDvyaEZXSoSK4ulGi7ii4slxGxksbPTQBYxKUCHzieIVaT4lXl0quLkQdshAJcmY988 x4QM8pAGXpAMQrr5nHqS+fjlNeZlBZwth1rdAJN+lx6Yj5tmNMW6oK1apSBI28qK8weJ J4NA== 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:content-transfer-encoding; bh=ruRfOYYRC+bqd80PrjHq4xcpVS6nhlqCW49Ofp7w16k=; b=O7r/yEWipFPLFPd/EPZQMxCj7TYwU+ybY1jYshLHZ9u3+dYtJ9gaDGQFYNso95+QUA eOYViEuvnGrJcW6fM+dKv/PUEeWjm2jgCqHj1dn0zb5m6cVmtlZJCVNtUg47KdmmI4j9 KQ7E5JhuCvfgMmXHN4n3QhpMvYgetC9tbOfXV+Q0mrg7hX5SxwJ0GdOje++g0UgvtE6e kH+jymRoDFTYmfIJkjC614n3jHwnrdSwKbJaXMNwLnpATj120rmtU1hSmMYJyjdk9s3d unfBM0yzr726u4Mv6prEs+zT4GbQoSqkTPjxsl25CrN8GwPjXmuH1TchXzAUMUmzEIY9 06tg== X-Gm-Message-State: AOAM530nLa6kL4YpCkDyBeA819GgvrysURi6tmaIdciK+mR2FNoR0w1Y EIKQjVirSKSuQ7PwxDAgkLYgMXztCjc+XAffD8o= X-Google-Smtp-Source: ABdhPJy1GROUb8BCU1stNLW2T+lIcIRIZ29n120BKSbYCYH/IsOBKsKsa6QPsWDrlv8LsnMaB9tfElfwHfUQsAkZ9Bw= X-Received: by 2002:a05:6808:1997:b0:2ce:6ee7:2ce9 with SMTP id bj23-20020a056808199700b002ce6ee72ce9mr278828oib.279.1645005260042; Wed, 16 Feb 2022 01:54:20 -0800 (PST) In-Reply-To: X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::232 (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::232; envelope-from=neiljerram@gmail.com; helo=mail-oi1-x232.google.com X-Spam_score_int: -3 X-Spam_score: -0.4 X-Spam_bar: / X-Spam_report: (-0.4 / 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, PDS_HP_HELO_NORDNS=0.904, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Original-Sender: "guile-devel" Xref: news.gmane.io gmane.lisp.guile.devel:21121 Archived-At: On Wed, 16 Feb 2022 at 09:04, Catonano wrote: > > Il giorno lun 14 feb 2022 alle ore 18:01 Vijay Marupudi ha scritto: >> >> > Is there any interest/possibility to have such a cookbook hosted >> > within the Guile official documentation (as it is for Guix) ? >> >> I personally think that a Cookbook should be an independent effort, with >> links from the Guile Manual if possible. This would lighten the load on >> the maintainers, and allow for quicker collaboration. > > > but then the discoverability of the cookbook would be diminished =F0=9F= =99=81 Yes, agree that the resulting cookbook needs to be easily discoverable. Perhaps that means that if you install a guile-doc package, it appears as a top-level Info item like Guile Reference does. Perhaps it doesn't need to be quite as specific as that. (Although personally I really like doc being available locally, e.g. in Info form, instead of always going online.) But as you also say... > [...] > > As for you creating a web site, I'd prefer such a website to be a communi= tarian effort, rather than depend on a single person > > Maybe a wiki on Gitlab could do and it could have several mantainers ? > I'd be happy to be one Yes, definitely feels right to crowd-source this, instead of having it centralized in the core Guile repo. It feels to me that with the right structure in place, people will readily come and contribute the detailed material to it. So it's worth spending a little time to decide the right structure. Best wishes, Neil