From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id iMYeOKEuLWVfCgEA9RJhRA:P1 (envelope-from ) for ; Mon, 16 Oct 2023 14:37:54 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id iMYeOKEuLWVfCgEA9RJhRA (envelope-from ) for ; Mon, 16 Oct 2023 14:37:54 +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 85E90451CE for ; Mon, 16 Oct 2023 14:37:53 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=Et1RlzfZ; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1697459873; 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:resent-cc: resent-from:resent-sender:resent-message-id:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=P5Qwg4KrWs1Hf6UJASraMhJ9gqeBKDHXV3C6TTC/72A=; b=ddaQk9ZfFDwNNSpDyXBoayQz4mcoquWgDJYLXpoNVmo2Ys36u3eYcz5KIcRlWMQtLiWY7L VbQufI34Qn2M6iF9og5Tz7SLRVlB//Hqd2iCSRnA3z2eey5u31ER0en+KJtivbU5ghJzC6 /l+lS+g9/tQg7nQLd9+k7eUn/Us1Up9LgDKaN4IsRo7IFKswRNy/hwOnEEi6JAxYo5BRH2 LJ3+wOvGgaqFOO5xGOnGk9EanFA2sg6QK3j2YXM4T2s2jb9B13+OY1Fg7ga7V/iZ9YNq/W iPeJUHzbmjmHOmPCqPAMxkGGRuvyo4AtkM0F7MqePakJNAGq+O3aXWyfeSB3Ag== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1697459873; a=rsa-sha256; cv=none; b=qMJAfBT33qf/nNQclq0lWcO0PZdqXif32KNJIMwSuDWUEgMB7Hm9+U3WDqDZ5wyOjld5rb PrWI1yyeDYKV5xze4h+qUchU/V66GlyLX1/C4IJToI5WwGR3rUkS+riSufW36uJ3zV7Bku O7e7qKOvlvgEhFC7vlJdVVT8I6ncRdtQZIxewa4NkoHhGs28ZZipJHhTXmMyTP+kZf8JtJ 1wskGkKTus8Wcu8T+Bu/L+3mQeL8FPE0rs24HvjJDC75aQVPKYdc9EDo8rYKq1RNdKJLNk vH2aOb/emJdvkTuICIr1u3g2AqrIvo+Gt1VEBaOgO7KWLRMT73qt092V4s6yrw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=Et1RlzfZ; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org 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 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Spam-Score: -5.87 X-Migadu-Queue-Id: 85E90451CE X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -5.87 X-TUID: L5NX4cZTcqlc 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 -- 2.41.0