From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id YMDoGXUL62QDZAEA9RJhRA:P1 (envelope-from ) for ; Sun, 27 Aug 2023 10:38:13 +0200 Received: from aspmx1.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id YMDoGXUL62QDZAEA9RJhRA (envelope-from ) for ; Sun, 27 Aug 2023 10:38:13 +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 5A80B5D4FE for ; Sun, 27 Aug 2023 10:38:13 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=jpoiret.xyz header.s=dkim header.b=KDWmhszj; 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"; dmarc=pass (policy=reject) header.from=jpoiret.xyz ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693125493; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=Sn/WQd4wKABFhN63m+ARGdeFr2ibwquHRPHqyy6Xfcg=; b=a0Qnhe3wAtAUBI71BYNxSskEyC/BkokWSJ+WKiM6JiqGBtLU5jujKkkI7Zk7QgJjqO8Ohj OwntjPMNnlFRnIB+0eczKux57P3i7vfwAX6iyHy5YI9YhhV0s5RV5YnC9LIaeXyFLI6g2V lVq/T6/7+8EvJhQJTenmUZB4eia8v06CdSuceY6b52Ixpgwn8+2049ZpVYWyZ/0q86YIbu O5b4Yrjio0QzbDFaWDvj//3aXNUro3hButoUjeibb/2R6j8G981LCWKHTiNX1Iyq4tXNnW gbS+bFF2JXIuEToQHtS1DO9OF8dh2wjyS2mVtFPsQoKLETo4N0f+o09r3tJ4LQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=jpoiret.xyz header.s=dkim header.b=KDWmhszj; 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"; dmarc=pass (policy=reject) header.from=jpoiret.xyz ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693125493; a=rsa-sha256; cv=none; b=QH9yjXra7D6/uml8udpTbWKMoQv/5wb9GqYi/env45debEiFMR6knG+d7Gc2JZxMt4LdL/ NsYaSdA8aYUxbGP+5+5W+2Uzz1t0CUNG3g6nl/UmdEypO+sZEHuRT+WsapaLaNo5tn28V9 xMYQDW/6m2WlhXqjv+wkPCHhomYrHa9ooEzDbj/yO7xzgok4IQQNNXJmtSl+6UHEXXOfZV aPy0mR6VXbz5x1noWy6SDst5DCTzIGHtN92hXVewD2KBU7AGHuUFl4Yl7UDZDqqhiPI5VF yLTzAbVF/qIAW8YS1iQOgtTP0FwyIZvDGg8hg5LVgaHDxOL4IpryP+BUJeYrPg== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qaBHR-0000Vn-Qr; Sun, 27 Aug 2023 04:37:57 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qaBHQ-0000VR-Ap for guix-devel@gnu.org; Sun, 27 Aug 2023 04:37:56 -0400 Received: from jpoiret.xyz ([206.189.101.64]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qaBHO-0004TK-6d for guix-devel@gnu.org; Sun, 27 Aug 2023 04:37:56 -0400 Received: from authenticated-user (jpoiret.xyz [206.189.101.64]) by jpoiret.xyz (Postfix) with ESMTPA id AE7E3184F27; Sun, 27 Aug 2023 08:37:52 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jpoiret.xyz; s=dkim; t=1693125473; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=Sn/WQd4wKABFhN63m+ARGdeFr2ibwquHRPHqyy6Xfcg=; b=KDWmhszjBIcyJjeG4sp/1lMEVs78P25nbmjoVYsdclctfT65waQYiJvyUjFUjgCSy6ewuV pM72CHIiY22IvV7ajLD1eZ5hYxsnKX+UNvOLPrbXQmcUAUxecFstOJMWq2JrftjOaDPRvO w+4Mb/c49LwIK2QJBvJuV2yyBHBvGYBKSn2oQ9ZLMIa6ZSh9CPc6AeMRvoKyvI0C3xMa/d 6E7JrDxgq21FMtA2Z6Y4c7knR56EgxvJfVqOndJ5e/uholLz04UEHqo9hVRyzbjX6f8WCo RfIdj/HUK4rQLaalGYpAmbGFExKQXkAyFC6xM+IobKssc/KZr7AY2IzwGUSCMw== From: Josselin Poiret To: Maxim Cournoyer , Katherine Cox-Buday Cc: Csepp , guix-devel@gnu.org Subject: Re: How can we decrease the cognitive overhead for contributors? In-Reply-To: <875y51jijv.fsf@gmail.com> References: <871qfsayyx.fsf@riseup.net> <875y51jijv.fsf@gmail.com> Date: Sun, 27 Aug 2023 10:37:49 +0200 Message-ID: <878r9w6ftu.fsf@jpoiret.xyz> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Spamd-Bar: ++ Received-SPF: pass client-ip=206.189.101.64; envelope-from=dev@jpoiret.xyz; helo=jpoiret.xyz 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_PASS=-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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Scanner: mx2.migadu.com X-Migadu-Spam-Score: -8.44 X-Spam-Score: -8.44 X-Migadu-Queue-Id: 5A80B5D4FE X-TUID: piEXAIzGFezm --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Hi everyone, Maxim Cournoyer writes: > Texinfo is mostly just plain text until you learn about a few decorators > :-). It gives us the info manuals that I find very nifty (it's like a > man page, but with hyperlinks and advanced navigation capabilities!) and > used across many GNU projects (e.g. coreutils, Emacs, Bash, GCC, GNU > Make, etc.) I see it as a strength more than a weakness for the > project. I agree with Maxim here, I think the texinfo markup is important to be able to generate such a nice manual: the Guix and Guile manuals are among the nicest to browse because of all the formatting that you have available, and the hyperlinks. I've also not had any issues adding stuff to the manual while not knowing anything about the format, just mimicking stuff found nearby. YMMV though, depending on what changes you might want to make. Best, =2D-=20 Josselin Poiret --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQHEBAEBCgAuFiEEOSSM2EHGPMM23K8vUF5AuRYXGooFAmTrC10QHGRldkBqcG9p cmV0Lnh5egAKCRBQXkC5FhcaiiFOC/41Swf2WMyCdMVtjJj7VPHg0q8s+7mQm8we xhmybqHamVjRTUljPB50iLFR0mBnReMvvehXP2mv9Axf3Lj5/23ZYlJp3rZw6+uH IHazWSdsUZ7JzOUJZ6dxnLc3Cz3OdmCBDemPPc5Ly9Sl4XVhXh2fi+5KSD1c7Dk7 AmF9TOk+2/rnFDXZ0gHfhB27GBBMekK/vkscrBsUD/FEFizZoKSzRIER/1QkHy5W gHZaPRW/fc7j9RpILH/An6cGBf2crqVngydggt1u1n11SI4oc82u6SODr3FPB+Rr q5EBPvF2aGquXlfBccigjG9aKDLjzAxsXkC22qhE778BYCT9dM3HPA6kw640s0p2 dsKspZ+GACN1h4trO6SZa7w8FkHK2M79/K3eOc1UjkDwQV0aM2FRbKMTsGEGppGj kWptYi+i7rJICi9Bd4e7EE66bXYWvCrGLUMMBPUZix9UgmJtXAHXTzlVNAESHjYC 8CDLjE6b5nUqAM35PkRrF5YbFsNL0QI= =VJ3G -----END PGP SIGNATURE----- --=-=-=--