From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id aJ6RCO5s7mLDYQAAbAwnHQ (envelope-from ) for ; Sat, 06 Aug 2022 15:30:22 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id WGuTCO5s7mKdWQAA9RJhRA (envelope-from ) for ; Sat, 06 Aug 2022 15:30:22 +0200 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 D7A96A5FF for ; Sat, 6 Aug 2022 15:30:21 +0200 (CEST) Received: from localhost ([::1]:55992 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oKJsi-0008Ms-Bh for larch@yhetil.org; Sat, 06 Aug 2022 09:30:20 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:60936) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oKJsQ-0008MM-4I for guix-devel@gnu.org; Sat, 06 Aug 2022 09:30:02 -0400 Received: from mx1.dismail.de ([78.46.223.134]:24842) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oKJsN-0000uX-IQ for guix-devel@gnu.org; Sat, 06 Aug 2022 09:30:01 -0400 Received: from mx1.dismail.de (localhost [127.0.0.1]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 0d98e97c for ; Sat, 6 Aug 2022 15:29:54 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=dismail.de; h=date :message-id:from:to:subject:references:mime-version:content-type :content-transfer-encoding; s=20190914; bh=E4Wv4P0WVn02nCxALyXaX lmqeTtfB49xy2EgquidMZU=; b=GBqO3H5T+W/wnyX1lxeM4weh9EEaS/8I3Pxs5 B5LPeA0nbCxJYqgpPlow98H85WhVVX0kBsw6xei5KS/7DXzl0RfMlX70l7mpvesa qnckyO1X+bd6VnkkMewJMyLhEqE6zOp2+XCghac/gg6xRKSP7P2zcw8Z7W8AQTHZ 4ZTqbU40nksq5P1ZJ6Z1fhvTvypqHkRJvauYOscRKWOaznPVHBbhV7VUsAq9zu8k njS0T+cSuJ/E2FdGumGc8LUPoo4F3kTHAYo2vUa1YV3LQSFNqoUfI+pSDZllAqki 7dy/laKKRV0bEUDs3h15URncRrZD3EIlK4L1FhrG4u8Oa4uNw== Received: from smtp2.dismail.de ( [10.240.26.12]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 0fbd5e1e for ; Sat, 6 Aug 2022 15:29:54 +0200 (CEST) Received: from smtp2.dismail.de (localhost [127.0.0.1]) by smtp2.dismail.de (OpenSMTPD) with ESMTP id d8f544d4 for ; Sat, 6 Aug 2022 15:29:54 +0200 (CEST) Received: by dismail.de (OpenSMTPD) with ESMTPSA id e7c42197 (TLSv1.3:TLS_AES_256_GCM_SHA384:256:NO) for ; Sat, 6 Aug 2022 15:29:53 +0200 (CEST) Date: Sat, 6 Aug 2022 08:30:01 -0500 Message-ID: <20220806083001.GC4096@gac> From: jgart To: Guix Devel Subject: Texinfo, Free Beer References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=78.46.223.134; envelope-from=jgart@dismail.de; helo=mx1.dismail.de X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1659792622; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=hxU5vGQEzZg954DfixzAVhnjqi06y/gb4IFnEQnreCI=; b=jyj/IeMv2s80VR0+2XsESqj7sTmijbBRHVpxGITwvvD7cacWaEdlh8ExqTDGTTD09bRZZ/ oQ80TvI67M0WKU9KGmuQf2XL+D0MKkjiHpPzSnCQF4pcC1dmjz0yCOw3+5/zPN9WBtJ5Nv Z1i/4nySt0NKPW/QodmPoG6O8sf+OvrpSlcXKhxtWsq0hhRU9RuP6u59XsP1hzuWePVPWW iutPRpmw0C+HHmBnGQ04fogu76gqQZ8Xl0NEnZbMAy1mbUYG9w1Mv2n2w3RA78F/tnGrI4 Ye6/PNoaS6CzqrPeT8Z8Vjg1U4HUA+ukdlofqRF7Y3U2ktO2FK23SdMx18XJuA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1659792622; a=rsa-sha256; cv=none; b=GGnE0B7y6DopUf8AQ13mc9Kxez77epW59y3n0EgHdhgfJyzsCsJTc+Gk7ZbYpdvN9xe5GF HGY6ujfCVqsGyCzcq0gyG6Qfbk2no3GSCI1Sm3nYVKRUXoKGFbDKrs2PypkSLd30BvUAmS T+jpyPoOR8bB8jRg+bYGzxzsbstDWLBA9lQd2fr3lr/SqM+UKBCt0fya4N8TQ2QKLpytbm UrbI40ToMpYHpciEmwOVC/WYPGMX5o8B9Fov5+Om0DycIQ5fHoNNhqiiA57wNg1H2uWmbF rVtqFiEUIWaNh8yO//Op/24KlkXVF26iH/AxmrgGE2U8NwwGJcaA4eGXWOgG5A== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=dismail.de header.s=20190914 header.b=GBqO3H5T; dmarc=pass (policy=reject) header.from=dismail.de; 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: -4.49 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=dismail.de header.s=20190914 header.b=GBqO3H5T; dmarc=pass (policy=reject) header.from=dismail.de; 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: D7A96A5FF X-Spam-Score: -4.49 X-Migadu-Scanner: scn1.migadu.com X-TUID: o7ktkIefJx4r Hi Guixers, wdyt of having some modern TLDR entry in the cookbook for getting Guix neophytes up to par with texinfo? Since texinfo is the defacto markup for the GNU Guix project and we're not likely to change it any time soon, I was think we could have some distilled/TLDR docs for users who mostly write and consume markdown. I was thinking something along the lines of what chicken has for rubyists or pythonistas: https://wiki.call-cc.org/chicken-for-ruby-programmers https://wiki.call-cc.org/chicken-for-python-programmers "Texinfo for MDs" roptat started a TLDR Texinfo guide on the learnxinyminutes series*. Should we just improve on roptat's guide and link it in a Guix doc somewhere so that it is more discoverable or integrate/fork it or similar into our docs? Same way we have a Scheme crash course, we can have a Texinfo crash course? It would be worth it since Texinfo seems more complex than Scheme from a syntactic perspective and our new documentation contributors could benefit from a crash course in Texinfo. I think the GNU docs for texinfo are TMI for a new user just wanting to write some Guix docs for great good. Another option could be to integrate guile-commonmark** into Guix so that we could support markdown in addition to Texinfo? Please don't boo and throw free beer at the stage. Nix used to mostly have their docs in docbook but now they support markdown and their users are much happier*** -- jgart * https://learnxinyminutes.com/docs/texinfo/ ** https://github.com/OrangeShark/guile-commonmark *** https://invidious.osi.kr/watch?v=WwgSMgpX6TM