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 QOj/BPFP22G5WAAAgWs5BA (envelope-from ) for ; Sun, 09 Jan 2022 22:13:21 +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 iMg+AvFP22E7WQAA9RJhRA (envelope-from ) for ; Sun, 09 Jan 2022 22:13:21 +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 0F5583F874 for ; Sun, 9 Jan 2022 22:13:19 +0100 (CET) Received: from localhost ([::1]:38002 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n6fV8-0006vf-EM for larch@yhetil.org; Sun, 09 Jan 2022 16:13:18 -0500 Received: from eggs.gnu.org ([209.51.188.92]:46690) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n6fUy-0006uW-4k for guix-devel@gnu.org; Sun, 09 Jan 2022 16:13:08 -0500 Received: from sender4-op-o14.zoho.com ([136.143.188.14]:17451) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n6fUw-0006gA-4G for guix-devel@gnu.org; Sun, 09 Jan 2022 16:13:07 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1641762780; cv=none; d=zohomail.com; s=zohoarc; b=OZW1ymzjYChNM9ebNXGjBXcSfZnz1dFVJJmdgHTjEokJJLHJeO8Js9q92cLo1cwmPXZlrr0rHYYKltdCk8fQ9FMCoLrwy7wThICMk5xszTkpgY6xWM0YZs2CiyilEL4eGglClzZ7/k1p8IXwGFcVFj+Gl3qSQlcc/VZjtLpPccU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1641762780; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=/FJrFTi2jMo6Bu/ccHNrdJ4zoNZQka29zBPKtQwDEYc=; b=dw5mK/Csd61Po7Q7NYrjKn/KKvORfyfYXLW+JIvCi26L8dVgokg5cVBfKIMDjIvtHyvNg/T2+XjC7BBwaQkpp2rcpOjgmeZWgNNTmTJNfTmKjvXBI4SR0caMgte3jlo6zWSUKbJxq5eS/uzkM/Ot6DBtw7ceo6z4jQ3ahI8KqMM= 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=1641762780; 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=/FJrFTi2jMo6Bu/ccHNrdJ4zoNZQka29zBPKtQwDEYc=; b=Kmbkw5prkayZaXSeEb5ZGTou4lRJZPCyc4eVY6T8RWbEPeRhhfNgHSV/JVz4TF38 fsassZXA38x6W2JN028PCACgFH94cFIGIzKKjHGpxbwfog+QBY08BaRukmwBrkFJYcx jbY2nyOp2eKiaeBKJniKTTld1lSQ5GCNDcbhmTxs= Received: from mail.zoho.com by mx.zohomail.com with SMTP id 1641762777379467.57550457787625; Sun, 9 Jan 2022 13:12:57 -0800 (PST) Date: Sun, 09 Jan 2022 16:12:57 -0500 From: Matt To: "guix-devel" Message-ID: <17e40afe906.c104327471465.5782260335382192651@excalamus.com> In-Reply-To: References: <87k0faa27i.fsf@elephly.net> <17e3a8189d5.bf62342823554.2534240434231206600@excalamus.com> Subject: Re: Guix Documentation Meetup 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: -30 X-Spam_score: -3.1 X-Spam_bar: --- X-Spam_report: (-3.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=-1, RCVD_IN_MSPIKE_WL=-0.01, 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: 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=1641762800; 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=/FJrFTi2jMo6Bu/ccHNrdJ4zoNZQka29zBPKtQwDEYc=; b=dXQUs3KkoEovBEiKkV1gHell45tZsj50VMuRt/a/yBchfW1ITPC+SqqiAkvmbbzzLweBz+ 98RakAIfprAtniHsAHivPw8tyjXQnd+yDn5YKO9zdV0MGzVRUzgKs7vF6/0mkIEIfMstjY KeiOnWmbp1Ndxt4EoQpruaLUYmg1AEDHMxUvjdRRXMzEB0KFa9pa5CfUVMDPO6lFME7YzH H9u+c6IPQyYyVQ/nKoQsN1DZCeSh663NfYHRA75z/u3TuQ1g46zYnDBFkIKljpebI9yFce 98onhwCFYfUhZZ0vsZWghjM22Fc8aeBeChpdS4YP5PWMU0FkIC+kN/4/S3Yrbg== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1641762800; a=rsa-sha256; cv=fail; b=XHGblM66H5xYJfjC+lyQwCPwl+snvnB+EabmmZ5ZhOEFVxIL77PNZVTn3O2PAWcFZ45AKP 9nsK4Rj5px+H8JOsSPCWTwq/Xkh3p81bsZBijM4A7dpkqi4+5BukstjfGEqxKTHCwARzvg qlk2RGw/mShQBGShD+Bd0Ktl3itCErD12drrX2ftxPyqww/a/uriTDJkG+svgXj95LQoF+ X99OC3b2IVzWljmyiBYoYdYi4/3lCozbKDjVqth3ed/Kpu/JqBl8cDtXHJ0iTfFaqh8aCK aW76o2MZoq/urgtWTSjt2HVG5hxn+7ZOtn4KSe+/rWim0Zj50de4DQ6M5MItTQ== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=excalamus.com header.s=zmail header.b=Kmbkw5pr; 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.10 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=excalamus.com header.s=zmail header.b=Kmbkw5pr; 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: 0F5583F874 X-Spam-Score: -1.10 X-Migadu-Scanner: scn1.migadu.com X-TUID: Va3R677R3jM/ > I see that this all seems confusing. Thank you for your response and for acknowledging my perspective. Yes, I find many things about the documentation process confusing. I can't speak for others, but I get the strong sense that I'm not alone in that feeling. > If you have something to > contribute, you should just mail it to this list or guix-patches. > Definitely, we prefer you send patches, but if that is too hard, you can > send your contribution in *any* form. I did. Maybe you missed the two blog posts I linked in the previous email? > I have two documents written in Org: > 1. http://excalamus.com/test-guix-case-study-plover-python-dictionary.html > 2. http://excalamus.com/2021-10-06-guix-debug.html The first is a tutorial of creating a non-trivial Guix package. The second analyzes the process of troubleshooting an issue. I share them here for two reasons. First, the packaging tutorial is, I believe, a reasonable candidate for the cookbook. It's ready for feedback toward inclusion, not direct inclusion. The software being packaged isn't ideal as it involves concepts which may detract from the main subject of packaging, like stenography. It's also for a plugin and not standalone software. Demonstrating the final package requires demonstrating the parent application which again detracts from the main subject of packaging. Finally, it's written using active voice which conveys authority on the topic, authority I don't actually have. This was my first attempt at packaging. Second, the troubleshooting post is not, in my option, suited for the cookbook. It is, however, a good candidate for a wiki page (similar to Arch wiki sections on troubleshooting). The last time a wiki was talked about, it seems, was in 2015. I'll start a thread for that.