From patchwork Mon Oct 16 12:36:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Ludovic_Court=C3=A8s?= X-Patchwork-Id: 1880 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 923B927BBE9; Mon, 16 Oct 2023 13:37:54 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.7 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,SPF_HELO_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 7C8C127BBE2 for ; Mon, 16 Oct 2023 13:37:53 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qsMqq-0003Ol-43; Mon, 16 Oct 2023 08:37:40 -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 1qsMqo-0003Oa-JX for guix-patches@gnu.org; Mon, 16 Oct 2023 08:37:38 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qsMqo-0005sh-BC for guix-patches@gnu.org; Mon, 16 Oct 2023 08:37:38 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qsMrC-000863-Qg for guix-patches@gnu.org; Mon, 16 Oct 2023 08:38:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbook Resent-From: Ludovic =?utf-8?q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 16 Oct 2023 12:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66577@debbugs.gnu.org Cc: Ludovic =?utf-8?q?Court=C3=A8s?= X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.169745983431059 (code B ref -1); Mon, 16 Oct 2023 12:38:02 +0000 Received: (at submit) by debbugs.gnu.org; 16 Oct 2023 12:37:14 +0000 Received: from localhost ([127.0.0.1]:55439 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMqQ-00084t-0X for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:37:14 -0400 Received: from lists.gnu.org ([2001:470:142::17]:42164) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMqN-00084Y-7Y for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:37:12 -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 1qsMps-0003E9-Ha for guix-patches@gnu.org; Mon, 16 Oct 2023 08:36:40 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMps-0005a8-9I; Mon, 16 Oct 2023 08:36:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:Subject:To:From:in-reply-to: references; bh=P5Qwg4KrWs1Hf6UJASraMhJ9gqeBKDHXV3C6TTC/72A=; b=Et1RlzfZZMt9U5 sRs4D2/Pv2GjFYUKAnO+AM5ORHf2eeP5MK0Hq5ZM+/tQeMRk7QwU3jL33FhGWVPlt2sLjuFmKRBgI BHlPyizf1CzJwBWjsEPSrTWgrCeX7bfnic44/geDOhV+sp+tX9XzEzlCdtbowYs3HsGRmsX/bNR4u 2DT7Twug8ekmVSNhvNKX549D60EYldfJiYcahbkJAJ0Lvcc2WWP7ykEiwvzVTG6lR+TDDlkwPph0N /0C9ZGJZqBUSopO/RPRN9T2TeHW7MV7TTjELykraqX9z0jYp0W9yvKCoWPtclLZ/tM1A0mggEhovP 2yY2sTXv5xXwjYLkOQ5A==; From: Ludovic =?utf-8?q?Court=C3=A8s?= Date: Mon, 16 Oct 2023 14:36:28 +0200 Message-ID: X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches Hello! These patches reorganize things a bit in the manual to make important things more easily findable to newcomers, and adds a word of caution regarding the section on multiple profiles in the cookbook (I’ve seen newcomers attempt to adopt that software management style on their systems, when it’s complex and in fact largely unnecessary since the addition of a fast cache in ‘guix shell’). Thoughts? Ludo’. Ludovic Courtès (4): doc: Move “System Troubleshooting Tips” below. doc: Mention Guix Home in “Getting Started”. doc: cookbook: Suggest ‘guix shell’ as an alternative to multiple profiles. doc: cookbook: Add cross references to the manual regarding manifests. doc/guix-cookbook.texi | 51 ++++---- doc/guix.texi | 257 ++++++++++++++++++++--------------------- 2 files changed, 152 insertions(+), 156 deletions(-) base-commit: a0d2ecde943bd1854ddbb7c0cad35a1fc64dc5ab