From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id YLEoL/A13mEZNAAAgWs5BA (envelope-from ) for ; Wed, 12 Jan 2022 02:59:12 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id 4NzVK/A13mFNLwAAauVa8A (envelope-from ) for ; Wed, 12 Jan 2022 02:59:12 +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 556103F8A8 for ; Wed, 12 Jan 2022 02:59:12 +0100 (CET) Received: from localhost ([::1]:44756 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n7Sut-0001KW-F7 for larch@yhetil.org; Tue, 11 Jan 2022 20:59:11 -0500 Received: from eggs.gnu.org ([209.51.188.92]:48450) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7StZ-0000Sh-2C for guix-devel@gnu.org; Tue, 11 Jan 2022 20:57:50 -0500 Received: from sender4-op-o14.zoho.com ([136.143.188.14]:17484) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7StW-0007v2-LV for guix-devel@gnu.org; Tue, 11 Jan 2022 20:57:48 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1641952664; cv=none; d=zohomail.com; s=zohoarc; b=kNRG8SxoXuK6FWKo4k7bFGr3L1fOJGh80YaLPZ6memkWYrJFc0tf23WkF1XeYks+SzffkD7ZceFUf68n7tiDdJWYbKo75hD0XFH99ZG7QAeGi/ax3LmQyHG09WyP8CHJKSBdL4ZZZH0zsjdmxmolF91u8m6zB8fYnJm1pvbIAYk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1641952664; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=3hOqypFfEiDvM0oGzxp+eSYaR8HCN7HsL1vWtDXoytU=; b=fjdsebOF92yCqlBJHBrcnLeGhIiYZXyRSnD2ZneRK6DaT2zO4UI5i+AkuAE/d52ecRJqY2ttR5aU9B+LTb5t8BwPhaqH8qbIaoitx8hOfA2IKNIBs39vShAueXELBih4sJZeiV9URSYbIZ6TXDZm+xaWVAxghI7xeh+kQOEnMSo= 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=1641952664; 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=3hOqypFfEiDvM0oGzxp+eSYaR8HCN7HsL1vWtDXoytU=; b=dsvasRzZdUjV0Jtr0rrjQxjzGHZu3ljkjzqxsut6lhrgcrL3HtvcdKMZpK7Qx53+ eRZzLlwwOShACYoQuBE2XhertbO++JT8zS4GQmaht1cfX3OqDRn0bwQVUrJgI5wsjrD S+b+WuFeEMop/N6HGyftQn+7A6o30LN3gFirZEo4= Received: from mail.zoho.com by mx.zohomail.com with SMTP id 1641952663502725.0534162217033; Tue, 11 Jan 2022 17:57:43 -0800 (PST) Date: Tue, 11 Jan 2022 20:57:43 -0500 From: Matt To: "Josua Stingelin" Message-ID: <17e4c0157b1.10c0ebd9d367025.4850987542317518993@excalamus.com> In-Reply-To: References: <17e40b111ce.bc05a4a071499.1598136714226569120@excalamus.com> Subject: Re: Guix wiki 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 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=1641952752; 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=3hOqypFfEiDvM0oGzxp+eSYaR8HCN7HsL1vWtDXoytU=; b=EAKQxlpOurq+EdXLk68qiQY8T1oebjOZqNoT86ZWepFe1eQtEoEj4M4d97dRduBUyrdXDC nDYCK8+grDw+NGJuZd6jm+DTbfBgjlz2cBtZMu3F9NGsJ4Poplm2M/7jaFFZH16nNNC8eQ zl1zO1IfmkXabmgSuNcc5xaskcKbnBRLetFyAFmC86EB+4SO29jv4nhp5vfJYuCd1/qwZE AFjQKhSgl6CIGotENh/PlbyvMg+pfWK3aBD05DXNoF9d796d1VEplY9fIw/QGwZg+Z8UdA 0pw3OtCDSKwYl/J5sTJchzOV4GFAUarLupEePNq5kJc/JtTd1I0InCkuMQvbZw== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1641952752; a=rsa-sha256; cv=fail; b=j3/OYbY2iycPKb0wk5kutwKmL68L5tFfI6Fdv+FSPepUll241nVsaZTNrEQWISzOgXTTv3 SqlsOPSPKCjA2ByuOfFz51SdC4XVYe5HO97ypjHVuU+exaJ6bHy8MY4X0Z0LjtuCWrgJcK DWxi28BlTTK15g98Ho0MesaunZwCsKoeMSMpr/EjOIelxGaKbON5cW7o7dnUvLcja7Zzt6 D0Dvd5NU53aYvyhcVZdtMGtsRW5ad/slEcNDgXiuB2ZGkZ2NRiboklauIQ0rbceh9snz3G sYQ6Gscs3pcy+0q0Pds8POqmSCMV59R63ThboDhdHD6moRrLdTaSrNkuOT5wJg== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=excalamus.com header.s=zmail header.b=dsvasRzZ; 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.11 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=excalamus.com header.s=zmail header.b=dsvasRzZ; 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: 556103F8A8 X-Spam-Score: -1.11 X-Migadu-Scanner: scn1.migadu.com X-TUID: 8FKx0X2Ul2N7 ---- On Mon, 10 Jan 2022 03:29:35 -0500 Josua Stingelin wrote ---- > I've been following the gnunet for a while so I felt qualified to comment. > > > Concern 1: guix will be soon be distributed over gnunet > Guix could provide an endpoint in the gnunet network for users that prefer to > use it. However there's no reason to prevent it from being accessible using the > current TCP/IP stack. > > The goal of gnunet is to replace the TCP/IP stack. It is built as an overlay > and underlay network. It can run on TCP/IP but could also replace it. Every > application using TCP/IP would have to be converted to use gnunet or > gnunet would have to emulate TCP/IP. Until then they'll run in parallel. Thanks for explaining. > > Concern 5: having a wiki may confuse what the primary source of documentation is (i.e. the manual) > > > > I'm not sure I understand why this is a problem. Of course, > > confusion should be minimized. But the primary source of > > documentation should be the one that best helps the user. Ideally, > > that is the manual. Is there a negative consequence for the primary > > source not being the manual? For example, how many of you have used > > the Arch wiki to solve problems for something other than the Arch > > system? Is that a problem? > > I suppose that depends on the user. As a new linux user I tended to only use > the information available for my distro. Only after knowing the differences > from the distros have I started to use a wider spectrum for information. > > That may primarily be a question of the target audience for guix? My guess, as Guix is a package manager, there are two audiences: package users (end users) and package maintainers. I'm curious what degree of separation between those should exist for Guix. > > Concern 8: the manual should have all the examples necessary for people to understand how to tweak things > > > > Agreed. Contributing to documentation also shouldn't be as > > difficult as it currently is, but here we are. Let's figure it out > > together. :) > > What about an online editing interface (analogous to Wikipedia) where everyone > can make edit suggestions. Optimally directly converted to a patch by the > software. Changes to the cookbook would have to be merged by the maintainers > and the community based wiki could either have a group of editors or a > consensus based workflow. > > > Personally I believe having one resource for information to be the preferred > solution. Maybe the Gentoo wiki could be a source of inspiration on what we'd > like to achieve? (https://wiki.gentoo.org/wiki/Main_Page) There is currently a wiki. I could see it being a sandbox for what the manual may need. But I also see disdain towards wikis by some here that's not unreasonable.