From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.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 yDFbHnhR2WGaUAAAgWs5BA (envelope-from ) for ; Sat, 08 Jan 2022 09:55:20 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id qG+pG3hR2WGycAEA9RJhRA (envelope-from ) for ; Sat, 08 Jan 2022 09:55:20 +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 294F143605 for ; Sat, 8 Jan 2022 09:55:20 +0100 (CET) Received: from localhost ([::1]:60890 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n67VP-00021s-5f for larch@yhetil.org; Sat, 08 Jan 2022 03:55:19 -0500 Received: from eggs.gnu.org ([209.51.188.92]:44616) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n67J9-0008Vm-14 for guix-devel@gnu.org; Sat, 08 Jan 2022 03:42:39 -0500 Received: from knopi.disroot.org ([178.21.23.139]:49176) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n67J6-00040N-Q5 for guix-devel@gnu.org; Sat, 08 Jan 2022 03:42:38 -0500 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 4365D61FDF; Sat, 8 Jan 2022 09:42:27 +0100 (CET) X-Virus-Scanned: SPAM Filter at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id AHOippb86ge9; Sat, 8 Jan 2022 09:42:26 +0100 (CET) Message-ID: DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1641631345; bh=zv289+TYmnXvdjP3FqSvBbQllXsNBQDomYpVXKB9xVg=; h=Date:Subject:To:References:From:Cc:In-Reply-To; b=CdVa4QhR8u/9K7A4Cw6k87hfh2fnNCYJQxtM0Ro1eMD6yTZcC9rcWBcfECilRC81K nZdy5Tl1fWCOs9QTQs8crjW85bulijOb0LwoYg0vwwhhgwbT+G2Cg6z/IvR8RDfF1T WEGngFx8IJH8XIWHbFru4z9ECyYczwGqDRwTMeq91bzCoO1J8Xaj9NQsj4FBIFqvWp UJdOAkLDqA+O6iLRRq4/8aZrR/n/Mhxg/Manbkiwws3MimV7dS2Kt0LU0ddJDklff7 1zXfARmjWQtlT+c2gYNleLbFjbcIoJAk1vSyej8GckIhdO5wFdBVLu+FU6wIkh9YxQ Ee/IUSlWvETBA== Date: Sat, 8 Jan 2022 09:42:35 +0100 Mime-Version: 1.0 Subject: Re: Guix Documentation Meetup Content-Language: en-US To: matt@excalamus.com References: From: calcium Cc: guix-devel@gnu.org In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Received-SPF: pass client-ip=178.21.23.139; envelope-from=calcium@disroot.org; helo=knopi.disroot.org 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, 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" 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=1641632120; 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=zv289+TYmnXvdjP3FqSvBbQllXsNBQDomYpVXKB9xVg=; b=ritrFUg6r9EVAkfLjg2wzkCG/BrjaJpTrGN+H3S8JyYo1AmDYXa9FVVtRpDNJ+isJkzPKu 7amdnAsCQxstjrdt4pNcUMBI+pVygqLoAqsBX4VIma8LYjpucdi8xfxjVw9dN7wgh/TNDH ptLXZODbFwigRP0nTqpa6+uFCg8Yh540Pp8s0RagdRBqx0ztJUIE9bCJp5gWfU41ZYS/55 szNpJuoKoXedzr0xsH2GUunjXSRRwOR5Cr6F3M4Gq43uMKcGE2amlFw4OKFCJ0RQ9Lrj4A sa5YY719L4jnF+CtdkkNBGArzpGe1AzLy20yxCaDhKIho65sDhgZthVCUHorMA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1641632120; a=rsa-sha256; cv=none; b=PnFFad+EVh0oSu+oNcnl1uN6jIe9Rmrj7TPjhAdDe1obta51CMxhjymUHddgG2SPbVGQTb 0bQ2sd58BQdKTfpjVpYCeJa7aA6GoOn75zRTd2QhRij8TYipmUa05AV8IobL1g678PZp0z iCrZwBweK4D3SHi+3AgI3VNXC853ti3eOGQgs+kBMQzotslKyIAIxHh3HOSdsj8MGXr3LZ 2ockzT+Jw3DaXfKcsgmcJdznrc2c4aOvJEleR1rCAYx15lA3Y4k2G5pzTWFEv6M5i6fnP5 widLCNdD5bEj7NxythKF3Z0B2IOcEozVQT3B3e398WklCzSefysyhfwuMKnp5A== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=CdVa4QhR; dmarc=pass (policy=quarantine) header.from=disroot.org; 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: -8.80 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=CdVa4QhR; dmarc=pass (policy=quarantine) header.from=disroot.org; 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: 294F143605 X-Spam-Score: -8.80 X-Migadu-Scanner: scn0.migadu.com X-TUID: F0eI9ihQA2Px I strongly agree with matt about the importance of discoverability that is currently lacking (`geiser-doc-symbol-at-point isn't enough). Its pretty hard to find out how to do something beyond the basic usage. I would like for Guix to host a community wiki (in addition to a more discoverable official documentation). Because a collaborative wiki that encourages effortless and low quality content could alleviate the problem of discoverability and context. This could serve as a stepping stone for users to understand the context (by reading what another user tried and failed to achieve) and to find possible solutions (avoiding the time sunk of dead-ends and maybe adapting an ugly hack into a cleaner solution, or even just using the ugly hack, instead of gving up on the use of Guix). The low quality wiki could also motivate people to correct misconceptions and submit better approaches ("Someone is WRONG on the internet" https://xkcd.com/386/ ).