From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id EDucHY1D32AHegEAgWs5BA (envelope-from ) for ; Fri, 02 Jul 2021 18:49:17 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id QHpAGY1D32AffQAAbx9fmQ (envelope-from ) for ; Fri, 02 Jul 2021 16:49:17 +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 B9EF825B12 for ; Fri, 2 Jul 2021 18:49:16 +0200 (CEST) Received: from localhost ([::1]:51776 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lzMLq-00055M-U6 for larch@yhetil.org; Fri, 02 Jul 2021 12:49:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54050) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lzMLe-000547-0d for bug-guix@gnu.org; Fri, 02 Jul 2021 12:49:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:53750) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lzMLd-00008M-PI for bug-guix@gnu.org; Fri, 02 Jul 2021 12:49:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lzMLd-0001bK-P1 for bug-guix@gnu.org; Fri, 02 Jul 2021 12:49: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: Fri, 02 Jul 2021 16:49: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.16252445286109 (code B ref 47630); Fri, 02 Jul 2021 16:49:01 +0000 Received: (at 47630) by debbugs.gnu.org; 2 Jul 2021 16:48:48 +0000 Received: from localhost ([127.0.0.1]:37059 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lzMLP-0001aT-Tq for submit@debbugs.gnu.org; Fri, 02 Jul 2021 12:48:48 -0400 Received: from mail-wm1-f52.google.com ([209.85.128.52]:43878) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lzMLL-0001Zt-Ga for 47630@debbugs.gnu.org; Fri, 02 Jul 2021 12:48:47 -0400 Received: by mail-wm1-f52.google.com with SMTP id q18-20020a1ce9120000b02901f259f3a250so6799679wmc.2 for <47630@debbugs.gnu.org>; Fri, 02 Jul 2021 09:48:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=FGAx6ReVp4tY2wmlsgjBiwRmI7cnDJqTR94EGV4SXmo=; b=NOzFX77OMmT24pRN5gIuYag3a+rBH5pI1+Wx5QAhdwYb1Ximr6PZRfyJwxrVfIidOF r7mlODHu0IKJX+WQxyw1QJhATeElujBlxHOKCh10Tsx/4eZaB81FQk9v4VSVXhYQwQOQ 4owkIBqkF4/S9I1dLeCsQVEI/K5ErsjyHRiNb64gjrG+NgKWPOwY7Z5hf5NhBXN3w1SW KWHK+nDbY6I5uVpVWwpdrcUc5g5UrLyVySOnmS+EN03eEBKce8B44ljvwaZTTrkKygOM Hz8srENaE9oAvlsABZcCp+TLiruB/BIHas4KFct0yPb7npNOfNJ65iH6bmvrDmyK69CF mYPg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=FGAx6ReVp4tY2wmlsgjBiwRmI7cnDJqTR94EGV4SXmo=; b=XYjZs1glyPqzAy/nfACVO1Sw+PDIie9tATL27jw++r+idW2Y9hJWj9+Sx8BdFrQ0z7 skihUkRxOEWbV7TeIxj+0NkDdAAJmFJUxkN96pBIvYG/vttG+h57qAEe5Ll/KKF3wV56 7MB+5BaKYT/nFT4QOdnenGtEZ9iqep1fabxzf21IGa8ODK8bnb5PMOgXR9lARt0qkZHw x/XZA65b1NiaJ65eOmNyMifHC4mxOkH9CGYGxiwZ9WcRY9n9FWygPCUTpmBFJUvy/cOz ikQl5CvdfE3T5YqKT8cE3NZYZBIPRwFw25Fi/OO4+PfEHt2oYY8jqGFA/3wwgT11KJTA CTJA== X-Gm-Message-State: AOAM531mUYUV/HFN6PSmU9nBdyzgRugo4j8feV8Gkwq1MYy+kZEmBAYI VoP9JfRjXIx4hDznxWZ/WcYcJJo99fs= X-Google-Smtp-Source: ABdhPJw4kNSm7k0Z0lsejANKqfEIYPPTY7fxJNx491UgQYmCF5z2V7/B3//sSWgJcq7uafN+IzRIPQ== X-Received: by 2002:a7b:cd8d:: with SMTP id y13mr716612wmj.131.1625244517925; Fri, 02 Jul 2021 09:48:37 -0700 (PDT) Received: from pfiuh02 ([193.48.40.241]) by smtp.gmail.com with ESMTPSA id c9sm3786135wro.5.2021.07.02.09.48.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 02 Jul 2021 09:48:37 -0700 (PDT) From: zimoun References: <2b1e7af8-40bc-1603-3cdf-e40dcaff9f98@riseup.net> Date: Fri, 02 Jul 2021 18:47:44 +0200 In-Reply-To: <2b1e7af8-40bc-1603-3cdf-e40dcaff9f98@riseup.net> (bo0od@riseup.net's message of "Wed, 7 Apr 2021 04:55:25 +0000") Message-ID: <87y2aoll1r.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain 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=1625244556; 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: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=FGAx6ReVp4tY2wmlsgjBiwRmI7cnDJqTR94EGV4SXmo=; b=JTDJwrlvfxU8oRss77BQElqmB2oM+ARN7LEojbfsjzk9RUYkxanVllT73DBBix2XH4Axlb AUlzyscIPSZwxlPqxowkGCvg6TAz4tLjY6pvHNxnqAjY3H1u3LzQkOJsWRak8dRCmMTCGA a1rmMWUnLOQ3euzTTcpdMArMA3gXa2LbZlOZC9SHgSoTzdN/EOsGpRyTyENoVT9Uys7jyP FbfJNe46nhyKhf8ZeZ33CploUMK4tsD5gyfd1cswghqTkkckVz5Z+2I8ptqjTrRHJ1c0XU iYUP01ISI2i1dwVlHNya4KPktvvQTrxTYQytmFop64zAeAmkG+ruc2r6/zKXSg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1625244556; a=rsa-sha256; cv=none; b=aVQtLW7PQ4GpdCq8SV54jtP/DfC7j4isnc+GYXDeccXA+pe2V93aYvQPJosbBwn/E2IDOr AyTow2/KRMmEKxJlEGMDOYcns7FWodqCPs1nVZGxaKqmQVG3BTCFIQTh5A181wro0W0qcJ BnhxrLRvgM5Pk9m2wRE1hQSJ5Y4pAf+nlgaHNnWd8XfljYv/t7mb7nIDJCh7M5ZDbFaGsZ 9IASJJr8QTmDi1igzq2fYMuMKs3mfAX9L/sCDKYK/o/V82K6yV5bteeRsME3d0VSia4peO sBWV74n+bG0Vl9UfdLq7DhJ0y+lNN/16LSnlFzQ33ugzTnIr1jaYVhPLXPjTOQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=NOzFX77O; 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.31 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=NOzFX77O; 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: B9EF825B12 X-Spam-Score: -1.31 X-Migadu-Scanner: scn0.migadu.com X-TUID: c+v1OhTlWkuq Hi, On Wed, 07 Apr 2021 at 04:55, bo0od wrote: > Checking here: > > https://guix.gnu.org/manual/en/html_node/Manual-Installation.html > > This section actually misses alot of commands and its not nice to give only > hint commands and leave step by step explanation e.g: > > https://guix.gnu.org/manual/en/html_node/Keyboard-Layout-and-Networking-and-Partitioning.html > > "parted /dev/sda set 1 esp on" > > This command wont work without labeling the partition "parted /dev/sda -- > mklabel gpt" and so on.. > > This mean user cant copy and paste he need to figure out the errors while hes > follow the documentation because it doesn't give to the user the full picture. > > I suggest to take a look at NixOS docs which goes step by step without jumping > any necessary one: > > https://nixos.org/manual/nixos/stable/index.html#sec-installation-partitioning > > (Unclear documentation causes unsolvable or ambiguous questions from users and > its troublesome to the support team to re-add the missing parts of the docs in > their support.(Assuming they figured out where is the issue user is falling > in.)) Thanks for your report. Could you propose a concrete wording solving the issues you see? Thanks, simon