From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id WP7/JgTIQGHLAAAAgWs5BA (envelope-from ) for ; Tue, 14 Sep 2021 18:04:20 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id uMO2IgTIQGEQFwAA1q6Kng (envelope-from ) for ; Tue, 14 Sep 2021 16:04:20 +0000 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 B83081AB7F for ; Tue, 14 Sep 2021 18:04:19 +0200 (CEST) Received: from localhost ([::1]:54228 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mQAuv-0001g5-0K for larch@yhetil.org; Tue, 14 Sep 2021 12:04:17 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:38518) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQAZO-0007ct-9A for bug-guix@gnu.org; Tue, 14 Sep 2021 11:42:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:38422) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mQAZO-00029t-14 for bug-guix@gnu.org; Tue, 14 Sep 2021 11:42:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mQAZN-0002zZ-Uh for bug-guix@gnu.org; Tue, 14 Sep 2021 11:42:01 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#47630: Improve guix manual installation docs Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Tue, 14 Sep 2021 15:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 47630 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: bo0od Received: via spool by 47630-submit@debbugs.gnu.org id=B47630.163163411611485 (code B ref 47630); Tue, 14 Sep 2021 15:42:01 +0000 Received: (at 47630) by debbugs.gnu.org; 14 Sep 2021 15:41:56 +0000 Received: from localhost ([127.0.0.1]:49968 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mQAZH-0002zA-OX for submit@debbugs.gnu.org; Tue, 14 Sep 2021 11:41:55 -0400 Received: from mail-qv1-f46.google.com ([209.85.219.46]:43657) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mQAZF-0002ys-9t for 47630@debbugs.gnu.org; Tue, 14 Sep 2021 11:41:53 -0400 Received: by mail-qv1-f46.google.com with SMTP id cf2so8152041qvb.10 for <47630@debbugs.gnu.org>; Tue, 14 Sep 2021 08:41:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=6xFbRpYlXNc9WUAr9pdKu3wsAyawf1GPVL7RbCLoCnI=; b=jeP0Qc+uKLQ8zBRyr+3StH7OOZ82dTbkVglD4lqGKDbr3x22IrLW4OK6PiTgBSUDmF pO4YIngkdIBqWuZW5EtUH/1VXn6TtsAWuFlUw9c53lsMr0CplQq0Z8C/wCV4EGBREZww 2BE3elcvP5FpN3yKV8UM+mwVREKwAia7Afk+12Shc6FpVGFwjrMzjydklyevgMRdE09Z 7FL97SKBfy02VVY9VqDojkYpeMZkoMYY5CPqEKGoQ8KOR4bXe4hgvnsr+TWe1vwyHE5C oZ+BbUdPZcmJmnF5a0q4MbJWHnK7syyOCTCGTu4/ArB0QljD8oh1xLcnllfdVYLhZSbt ZSlQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=6xFbRpYlXNc9WUAr9pdKu3wsAyawf1GPVL7RbCLoCnI=; b=wzcLM42jfBJij8i6UdZ+N9zkEFrfhU0ivoC7MJa2w/EQ+87qMVStCwNbgDoy7XyR3Y LMp8+kVtq1yVBk6cFMuyQSf1idspg5I5ut/CHPHS3vaEuSsHMnpKYoQm64qRVT6xYxa8 APvk2F0LqYNJ/iCLLzY+eq8jJS2ZZ6kE419CCa0EQt5xDfQcb6SIWOc2mMDL/33Mz4DZ KzHGcHPpzN9ZIMdV/RDtPJnbensOwDvOZ/aAdtBO9lEKAAiVI0qHXtHtTlIdpqAFd2Bx Afn5ghEz3fisyDMajWrWN1Fh2VyuW8NWZyEwyXV8PNhuBzAuylde3y7xd9gwT53ZyqTy Gxog== X-Gm-Message-State: AOAM5309I1q6tRa9wI9kgG/TYJGs7/o2P8qY+qpcYknJx0YmF3TyCfU6 D/iZWsZOUE14UdJ5Z4Lr9swNB05HNjXi0QY/dCk= X-Google-Smtp-Source: ABdhPJwFcdHORNpRhAzNyNAEjimfuOpGSxGaFQ/ihC/MhUnwH1bPi4kJFfqk8oGoPErPsJHMjFtDhzFvfJbjtfXDjfc= X-Received: by 2002:a05:6214:2e7:: with SMTP id h7mr6093940qvu.39.1631634107681; Tue, 14 Sep 2021 08:41:47 -0700 (PDT) MIME-Version: 1.0 References: <2b1e7af8-40bc-1603-3cdf-e40dcaff9f98@riseup.net> <87y2aoll1r.fsf@gmail.com> <865yw3n4lv.fsf@gmail.com> <865yv3v413.fsf@gmail.com> In-Reply-To: From: zimoun Date: Tue, 14 Sep 2021 17:41:36 +0200 Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: 47630@debbugs.gnu.org Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1631635459; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=6xFbRpYlXNc9WUAr9pdKu3wsAyawf1GPVL7RbCLoCnI=; b=upVziwbjecQmfmMLfA69e7PeDpGmPw/eHKhK/vgQcrF84LkH9lQMfa6Yu/7821ZWLbGKqs YuCu4S3xjEzD24acNKUtawA/mi4OrD1hYhepH/0Olvoz6c6h8cFJYQAqJiSgJYDc8qWPlP WGPUFGrqBtDtJvlA/WG177z4qxMNABiVCoFL75J0An+lnLqFJcDaMmWK+MeFzGpauvmXip 1Er03rwqIOt+rtKK0Fe9Vgm/6pZVa9MJs/uTV3q6V4MshiqB8W2MlYn9kxlj9ECdO/X/sr i8c6Jh441ByWY6WiTi9YOkxipWHDdbtfEqBz7hJMNBrSf4/La1csdKadrVPZDw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1631635459; a=rsa-sha256; cv=none; b=TRQS2OpD7g1NniPLNPJDNaVF9pwdnGUU5b+5u9nE8KdlBYGIulwvY/qBMjZ9fanGHtqYpY sgXD9Zn8tYOiGIeYcyeGTHnlh7QoJ++qrZg7rginslFy2zqfQfg+YGdyHG5cpLWDcrxhYd iVtSpDTFNt8ZYWKw4hiHW0QniVXwF45dwL+j1CRgYK1y9tAdsGsivZlFJk5599uAjtbu4w HdI2DWa9cogPvwCVwhqs/7B1vEk8YK0RYk5+S4JFYZsES7Kwz3Yzn37fQQxHqKNVZ+1sSK AbG5LelKtPNFgpJlPv3onQcvmoTo4oP+BUt8hANIVrGSM7ACykA9KVnTiG5reQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=jeP0Qc+u; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Migadu-Spam-Score: -1.30 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=jeP0Qc+u; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Migadu-Queue-Id: B83081AB7F X-Spam-Score: -1.30 X-Migadu-Scanner: scn0.migadu.com X-TUID: cxlCY7XGPgKp Hi, On Tue, 14 Sept 2021 at 16:51, bo0od wrote: > Fix the documentation as steps works for the end user as if he follow it > 1 by 1 copy/paste (similar to nix docs as example), Otherwise current > steps in the docs just junk to the end user. (you dont expect users to > know and finish steps themselves) I proposed you to write down these steps as a starting point for improving the manual to turn it into a patch (for the Manual or the Cookbook); this is actionable. Otherwise say =C2=AB improve this part of the manual =C2=BB is not constructive; this is not actionable. I (and probably others) do not see what could be improved in this area so it appears to me hard to improve something that I do not know what. :-) Last, the manual says: This option requires familiarity with GNU/Linux, with the shell, and with common administration tools. If you think this is not for you, consider using the guided graphical installer. Therefore, it appears to me expected that this section provides only command hints and not one by one step to complete all the process. Other said, I expect that user who does not know how to fully complete will run the Graphical Installer. Does Nix have a Graphical Installer? All the best, simon