From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:8:6d80::]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id UK2kCGCjbWAkzwAAgWs5BA (envelope-from ) for ; Wed, 07 Apr 2021 14:19:44 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id 4JGfAmCjbWBVCQAAB5/wlQ (envelope-from ) for ; Wed, 07 Apr 2021 12:19:44 +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 829EC1CD37 for ; Wed, 7 Apr 2021 14:19:43 +0200 (CEST) Received: from localhost ([::1]:34700 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lU79q-0000qi-Mh for larch@yhetil.org; Wed, 07 Apr 2021 08:19:42 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37884) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lU0EU-0001Fy-GM for bug-guix@gnu.org; Wed, 07 Apr 2021 00:56:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:59497) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lU0EU-000868-9B for bug-guix@gnu.org; Wed, 07 Apr 2021 00:56:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lU0EU-00042l-95 for bug-guix@gnu.org; Wed, 07 Apr 2021 00:56:02 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#47630: Improve guix manual installation docs Resent-From: bo0od Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Wed, 07 Apr 2021 04:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 47630 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 47630@debbugs.gnu.org X-Debbugs-Original-To: bug-guix@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.161777133715506 (code B ref -1); Wed, 07 Apr 2021 04:56:02 +0000 Received: (at submit) by debbugs.gnu.org; 7 Apr 2021 04:55:37 +0000 Received: from localhost ([127.0.0.1]:42810 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lU0E4-000422-V5 for submit@debbugs.gnu.org; Wed, 07 Apr 2021 00:55:37 -0400 Received: from lists.gnu.org ([209.51.188.17]:56286) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lU0E3-00041u-EN for submit@debbugs.gnu.org; Wed, 07 Apr 2021 00:55:36 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37816) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lU0E0-0001DL-Dg for bug-guix@gnu.org; Wed, 07 Apr 2021 00:55:33 -0400 Received: from mx1.riseup.net ([198.252.153.129]:44058) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lU0Dy-0007bO-BU for bug-guix@gnu.org; Wed, 07 Apr 2021 00:55:32 -0400 Received: from fews1.riseup.net (fews1-pn.riseup.net [10.0.1.83]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "Sectigo RSA Domain Validation Secure Server CA" (not verified)) by mx1.riseup.net (Postfix) with ESMTPS id 4FFXC502rMzDq7w for ; Tue, 6 Apr 2021 21:55:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1617771329; bh=bwHjXROZkOIJ5eoVeku4ixtRcWizZcorZ4iuxgVYzU4=; h=To:From:Subject:Date:From; b=Ma41TJZ0ojL+S/JZyukngF+sCYYriMXcAetr3KaiwAg6r6MGD5TMKR7b36Mns5o+t kyWOOmBGywdFkU/XWd25T8F2rx/uDptuy+WpaU5RVohQ+bgqwSeoWUEoJ/NWGkRY2P NhYyOOFf+yMFGJGGglOyu8xQPeiTwBt4sJkl3sXI= X-Riseup-User-ID: 09608AC343F1508D45FD30B048D77236F7350174A47710C193DAEC0C5812EE1A Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews1.riseup.net (Postfix) with ESMTPSA id 4FFXC41bcSz5vhF for ; Tue, 6 Apr 2021 21:55:27 -0700 (PDT) From: bo0od Message-ID: <2b1e7af8-40bc-1603-3cdf-e40dcaff9f98@riseup.net> Date: Wed, 7 Apr 2021 04:55:25 +0000 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit Received-SPF: pass client-ip=198.252.153.129; envelope-from=bo0od@riseup.net; helo=mx1.riseup.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Mailman-Approved-At: Wed, 07 Apr 2021 08:19:17 -0400 X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , 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=1617797983; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to: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=d6Mlsi2d0tnI7FEyFJqjvJaU0pGryA2qrLrtDbtLGGE=; b=l897zSLfvqO/QMMIJ5/bR6OexDkBdomqx5AI9quF+KV8DqPKl6hzxa3DvibC8VCP9pbRV0 5ZJ3srn2whxkpLBPTt9sBDIZNMrWX+8EvDwCU9D0zhVMspv83cBne8LOd5gr31wgtW56rJ Keh3xbJ80eI1ra04VSLL8Zye5WmugHaqkb7T3geJNC0A7ICrX+4LsnlB0WQXnwtyjNnwKg XFUpxKEKg8+sLtM2CCYq29vhGeUxkXw0fOVZeSRVBBQYeTQHrbkxTIL0K8KwhdTeJPDBiF E96NCSGYhISaWtxQVpqAJ9dGQG8Cbe1ybwx0ZFoOs+cbtkRfAlppMf1zDTFcgw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1617797983; a=rsa-sha256; cv=none; b=L5c1fgI575iSPm/a9gnG/u8YGjsgmA8bIu8+9N7Rl/pcX+XjUQ/k4DLwfD1SauWirpmNAO 72qACPhzQdABIoR1Kbd3lm93b9xPFN/lv1wzssuHF6Y/2YPsx5EVvNqci52NgcJYvhgY6O O8Nkmz0LMkmw0raTjcfIcqUiL1jLcTEFW/KhVdJ4csBi1N5LtUB2x0+8K4f0ywL6KrvE0H 0aBDYHFtsi1WmFZKScekqxgYKcoFcElyeHR3x8vCLXo4LsozSU8qdC/tJnzeuTykBHlUTD Lm4HqKipOMyfuI1CIwL/iqVh6oFinymiXkz7JZheqPE44EUbIBjUCjtdj556lA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=riseup.net header.s=squak header.b=Ma41TJZ0; dmarc=fail reason="SPF not aligned (relaxed)" header.from=riseup.net (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.34 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=riseup.net header.s=squak header.b=Ma41TJZ0; dmarc=fail reason="SPF not aligned (relaxed)" header.from=riseup.net (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: 829EC1CD37 X-Spam-Score: -1.34 X-Migadu-Scanner: scn0.migadu.com X-TUID: xTnzJdJYXGx5 Hi There, 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.)) ThX!