From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id WKMFLMatv2BoSAEAgWs5BA (envelope-from ) for ; Tue, 08 Jun 2021 19:49:58 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id 2PFKJ8atv2DfbQAAB5/wlQ (envelope-from ) for ; Tue, 08 Jun 2021 17:49:58 +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 969C21DF62 for ; Tue, 8 Jun 2021 19:49:57 +0200 (CEST) Received: from localhost ([::1]:37184 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lqfrQ-0006ZC-N0 for larch@yhetil.org; Tue, 08 Jun 2021 13:49:56 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50818) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lqfqY-0005QH-Fr for bug-guix@gnu.org; Tue, 08 Jun 2021 13:49:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:48197) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lqfqY-0003Ht-8I for bug-guix@gnu.org; Tue, 08 Jun 2021 13:49:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lqfqY-0001no-61 for bug-guix@gnu.org; Tue, 08 Jun 2021 13:49:02 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#47630: Improve guix manual installation docs Resent-From: Eric Brown Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Tue, 08 Jun 2021 17:49:02 +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.16231745406920 (code B ref 47630); Tue, 08 Jun 2021 17:49:02 +0000 Received: (at 47630) by debbugs.gnu.org; 8 Jun 2021 17:49:00 +0000 Received: from localhost ([127.0.0.1]:59743 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lqfqR-0001nS-Kq for submit@debbugs.gnu.org; Tue, 08 Jun 2021 13:48:59 -0400 Received: from wout2-smtp.messagingengine.com ([64.147.123.25]:57403) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lqfqL-0001nD-RP for 47630@debbugs.gnu.org; Tue, 08 Jun 2021 13:48:54 -0400 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.west.internal (Postfix) with ESMTP id 12D8B19F7; Tue, 8 Jun 2021 13:48:44 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Tue, 08 Jun 2021 13:48:44 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericcbrown.com; h=from:to:cc:subject:references:date:in-reply-to:message-id :mime-version:content-type; s=fm2; bh=YN+lpBp0BJ1g7idlzoJ+kZDnwO x10dLQwqkUVISjBUs=; b=sP297JF1pEcwEOhVmKmW1nYOkCvcO5Yqz1Re0KKEcH hKeIVPvDt094NdXPNXHetox+Niqtvc4CIUkcEPkJbq1vsEx+gnliWRphQqEWSjSC DOdY3Z90DfiimSSfImDcA9b+xu8iiL2fYnYFcN2OCFVrwJ9gYd9FJoY9Zg3vbIIY GKamGDAsxqw+zjO3/YvHfUs5xiE4ySc+ddVnznZNnAWL3EkJBGTOWntM1lSRK0wR mV2oJWQQwAZeouZSblieLkdmlUARc0YcQE1lGbCNmqouYSgEwX5L7jib7ZuS9URB kfHlj4VClbNsqzkMdhvmTjdipDn9k6D6F7jIIGAKF0oQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=YN+lpB p0BJ1g7idlzoJ+kZDnwOx10dLQwqkUVISjBUs=; b=AlsKuzoyaePBqvxpXqu7xD ysBOlieJoov4IZAXfMgFWxqZTc41R3HHKYbGLyzD5Ez64s4Y096TdTqxrRkASfjP PwgfP/8ad5lfVMMz8qxETZuM/S0bodwPYDz7wgsrtEM2CvNq+J5tzEr8Df5WdKVi hDTD32oKcReP7DC9k6hecDBc8I+IkGykSAsi8Ub9TWxoNWaEeKfZQAKf5nMgCKuj gbZHjSVWnbw854YCBbxLQRJHjRVbA+r94NCZUuhqO3J5KCIJ3dauKBax43bkSUZ1 b7X3yYZRCYDssqrCLOcGYr8yhlKpLbwX/Yn+pq8LiagWPK7NPtw3v4jwbLnaiunA == X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduledrfedtledguddtvdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufhfffgjkfgfgggtsehttd ertddtredtnecuhfhrohhmpefgrhhitgcuuehrohifnhcuoegvtggsrhhofihnsegvrhhi tggtsghrohifnhdrtghomheqnecuggftrfgrthhtvghrnhepveefgfeugeejffdvtdeggf ektddvkeefudeltefhgefhfefgtdduvdelfeffheeunecuffhomhgrihhnpehgnhhurdho rhhgpdhnihigohhsrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpe hmrghilhhfrhhomhepvggtsghrohifnhesvghrihgttggsrhhofihnrdgtohhm X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 8 Jun 2021 13:48:43 -0400 (EDT) From: Eric Brown References: <2b1e7af8-40bc-1603-3cdf-e40dcaff9f98@riseup.net> Mail-reply-to: Eric Brown Mail-followup-to: Eric Brown Date: Tue, 08 Jun 2021 12:48:42 -0500 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: <87wnr4s0w5.fsf@ericcbrown.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=1623174598; 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=YN+lpBp0BJ1g7idlzoJ+kZDnwOx10dLQwqkUVISjBUs=; b=exXB7AoU/grDw43N11O8FH4OG5kgKrBf3A2jcw9iOakk1wk4v3+uKqCZtZBSVFsPINom7V QONRo9GiPyAjpZKBRxhKz9sOIR50dVWTzVpGCT2qnLzj1m3JOAj5ltIpk48zTMZifU+6P4 mNIYEFNfN1ZcgkRBVtk0THD8TpGUH8PYzQE+K/iJUGIX5y1LDGSfIDs/5+Ejudrl/ZRQaV n4w10r0GZxUafbDCAkIzwg0sqQzP6RB0n2R3FVbWCLZUwThWbC60i9SEMn/tPGEklYLlzA Bk+sepU+u5YjY9TD3KZ5GOkp/fVtPdmcJxIDDk7CM9bN9vwLv0VuP2U9tgq9Uw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1623174598; a=rsa-sha256; cv=none; b=uy1CeJL6ppX7vi3gid7VszjyvJlPV4SvLhkiyncG3BqrXZA0YLxbAwkmB/P1r15mNStMrQ pDSStT3Mt33MZTrdTjL/nbHCAMCpTmqdMQLhC8dlJ6vuDQNNougHOOaksZm4QysZLNhgkK Rn5ZWF8jUcvf1X7127EEASwJwY5lA8Izk3eEgDHnr6cCdDvCEq3VvjZMIaT7sck7R5iTbg huisS+uUFnCEbHWXLl/Z+9Sdw+Hr8qnxsuu2YOGnDtDhSZZINjBKeyj0hUe9d221lfR/q8 QIyliSEM0bRYCpi7i9zeSX7PN9hm+tpBbfY/6+Ex00crq1c44FpS0TrqlPbC1A== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=ericcbrown.com header.s=fm2 header.b=sP297JF1; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm3 header.b=AlsKuzoy; dmarc=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.42 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=ericcbrown.com header.s=fm2 header.b=sP297JF1; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm3 header.b=AlsKuzoy; dmarc=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: 969C21DF62 X-Spam-Score: -1.42 X-Migadu-Scanner: scn0.migadu.com X-TUID: fyTPM7WFJV4f bo0od writes: > 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! If you would have rolled your suggestions into a patch, then your support team would not have to keep re-implementing it.