From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.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 KNvlLy9w7mKwOQAAbAwnHQ (envelope-from ) for ; Sat, 06 Aug 2022 15:44:15 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id kLf2Ly9w7mIv+gAAauVa8A (envelope-from ) for ; Sat, 06 Aug 2022 15:44:15 +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 3B082AC6D for ; Sat, 6 Aug 2022 15:44:15 +0200 (CEST) Received: from localhost ([::1]:60898 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oKK6A-0003vR-C1 for larch@yhetil.org; Sat, 06 Aug 2022 09:44:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35258) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oKK5z-0003vD-8x for guix-devel@gnu.org; Sat, 06 Aug 2022 09:44:03 -0400 Received: from mail-4323.proton.ch ([185.70.43.23]:21817) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oKK5v-0002rm-D1 for guix-devel@gnu.org; Sat, 06 Aug 2022 09:44:02 -0400 Date: Sat, 06 Aug 2022 13:43:35 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=elenq.tech; s=protonmail3; t=1659793428; x=1660052628; bh=xHlAwf2Us7E59Km01cM3An3QJI0ZFAD+h62a5qpwU3s=; h=Date:To:From:Cc:Reply-To:Subject:Message-ID:In-Reply-To: References:Feedback-ID:From:To:Cc:Date:Subject:Reply-To: Feedback-ID:Message-ID; b=G0kPFyFGZ7fXBilp7j1psf8YLf5LIsuOsg7QpaBH1RaL3gyowOcpEUKBp60NTA1eJ m117ElkjAR+TORyxT3Y56aMb1z/Q5VGECs8Hu5KgoWZn7/5DUH0U1pg48pT+S1BOX8 T0tv7uW6U9+RgAHrSVQ0vPJgu1Y34WHaFEi4L58GRzI3Zy0lYFlMI1YnkFLEQ33NVh qgkdepJz6Re8wqEr2ppiDIHdNJ7qLDS3a69FtfZF/8enSyBVNVtRJEtUA03UsuFM1T tZW7xV4pbnFnqRY24eKzGIvik6CQ1wWxPxFxqwSNykv9oC/WZgUHPCAN0KgdgomqgU rKBNvNLEAe3Jw== To: jgart From: Ekaitz Zarraga Cc: Guix Devel Subject: Re: Texinfo, Free Beer Message-ID: <5fQ7uqkVOMe_sS0Ch-N5LSLJ2dTl9DOrnoDmP-RhWL3H3jTM-DCXuLVhqBGtHZHRi-16uDXLkKodWgEx_GfsjOXtCLRnQkW5OQPWuvu5bVU=@elenq.tech> In-Reply-To: <20220806083001.GC4096@gac> References: <20220806083001.GC4096@gac> Feedback-ID: 3263582:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.70.43.23; envelope-from=ekaitz@elenq.tech; helo=mail-4323.proton.ch 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_MSPIKE_H2=-0.001, 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: , Reply-To: Ekaitz Zarraga 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=1659793455; h=from:from:sender:sender:reply-to: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=xHlAwf2Us7E59Km01cM3An3QJI0ZFAD+h62a5qpwU3s=; b=MISiQgWHdufmJBZrHizMwhs+KrDDwC9dQNwd+vK17rydAJOLiNK1FS3kxMyQ2QeWM4U02G eVdEYL/qMAqWkxsyQ6AFRjqcbcugzQbTf7W9HjMjp3uOjp/hdvaxNPvPk/Cf//7cuJUvAR GwhIEkxXmRAdIbGXyDL3YIgD3/YkY+dVj10V8uoIvc2rgSvhWquiwNErRWlqVpSiD+RkFW TRym/c3eBkhwF9IxvrORnKCrMpkVXQYAARXcYmKhkhUXTsZG6PTkGbcZb1QeQdD6LRfedD Mlv5K1ohzBzUY//8zxcCkWageulwEhs1dVtLlUf3WItnViV3p2QtPW2xJCookw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1659793455; a=rsa-sha256; cv=none; b=m25XT53313MTAYskvnuAENAZd0MPoInUa7QR8En9uGkZ0kGK+MHNnS6fxmmXs+M/qWpsAW zwwwYvW4WFJSZ2ni7o82CBI1JGu6qXl+/7vHtqTj3Ff2b/AGRtWuOfm9zp3DeIuObJ2ywr e5MsafhNTeA3BLLw4pcSIFlzgi9WoDACV/BQH3cvsQU8u3yPG+KKJ4cYhCDJXgMXiKrexb iPaBnewMbayCLeiTcOfZuEPfrgtmc6Hz11xQND8TQObo2kkJirblwQB0ddMnMN9bwyykTt +ob0UhzEor1F+Vm0yf1GAMJmmNVnUM+3WqsGSdYLyW8lQmMGIx7kQeS9S1meyQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=elenq.tech header.s=protonmail3 header.b=G0kPFyFG; dmarc=pass (policy=none) header.from=elenq.tech; 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: -3.89 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=elenq.tech header.s=protonmail3 header.b=G0kPFyFG; dmarc=pass (policy=none) header.from=elenq.tech; 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: 3B082AC6D X-Spam-Score: -3.89 X-Migadu-Scanner: scn1.migadu.com X-TUID: IKg6gHOvyT+Z Hi, ------- Original Message ------- On Saturday, August 6th, 2022 at 3:30 PM, jgart wrote: > Hi Guixers, > > wdyt of having some modern TLDR entry in the cookbook for getting Guix ne= ophytes up to par with texinfo? > > Since texinfo is the defacto markup for the GNU Guix project and we're no= t likely to change it any time soon, > I was think we could have some distilled/TLDR docs for users who mostly w= rite 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 somewh= ere so > that it is more discoverable or integrate/fork it or similar into our doc= s? > > Same way we have a Scheme crash course, we can have a Texinfo crash cours= e? I could use that!