From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id QIfEFK8w8GBbFgEAgWs5BA (envelope-from ) for ; Thu, 15 Jul 2021 14:57:19 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id GAmPDq8w8GB6WQAAbx9fmQ (envelope-from ) for ; Thu, 15 Jul 2021 12:57:19 +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 E926998BC for ; Thu, 15 Jul 2021 14:57:17 +0200 (CEST) Received: from localhost ([::1]:47284 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1m40vU-0000CZ-8Y for larch@yhetil.org; Thu, 15 Jul 2021 08:57:16 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35738) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m40vI-0000C4-7J for bug-guix@gnu.org; Thu, 15 Jul 2021 08:57:04 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:35492) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1m40vG-0006ub-F7 for bug-guix@gnu.org; Thu, 15 Jul 2021 08:57:03 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1m40vG-0006xl-AS for bug-guix@gnu.org; Thu, 15 Jul 2021 08:57: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: Thu, 15 Jul 2021 12:57: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: zimoun Received: via spool by 47630-submit@debbugs.gnu.org id=B47630.162635379426729 (code B ref 47630); Thu, 15 Jul 2021 12:57:02 +0000 Received: (at 47630) by debbugs.gnu.org; 15 Jul 2021 12:56:34 +0000 Received: from localhost ([127.0.0.1]:47038 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m40un-0006x1-Jv for submit@debbugs.gnu.org; Thu, 15 Jul 2021 08:56:33 -0400 Received: from mx1.riseup.net ([198.252.153.129]:34068) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m40uj-0006wd-Nj for 47630@debbugs.gnu.org; Thu, 15 Jul 2021 08:56: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 4GQZBH69SZzDwfG; Thu, 15 Jul 2021 05:56:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1626353783; bh=fZQIn8whIsrM+uiT+TFvmZlEj/kwe+TDpV9ZyFbVFrg=; h=Subject:To:Cc:References:From:Date:In-Reply-To:From; b=J0BFnoz6JOCwN+5tRkmDSDZXwSEOsoyLn21Uz5ELGODK+ecbxRWt7xJrV+T5RcsUa RyfRp/+4EmcSKdfC5ZOvpOnpKPtiTF2GqmaLm/hhpMyGszUbCq9/icKUV041W7GvFa IosryLcbXHRaV+qN3SphnE1bD1yPX8EAuj6lZ8Vk= X-Riseup-User-ID: 7AAC3ADBCE06B6E3E233DA376E70F347266CF2BEC84CA33AE4EEDBEBD8F487AF Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews1.riseup.net (Postfix) with ESMTPSA id 4GQZBG3JkYz5vYk; Thu, 15 Jul 2021 05:56:22 -0700 (PDT) References: <2b1e7af8-40bc-1603-3cdf-e40dcaff9f98@riseup.net> <87y2aoll1r.fsf@gmail.com> From: bo0od Message-ID: Date: Thu, 15 Jul 2021 12:56:17 +0000 MIME-Version: 1.0 In-Reply-To: <87y2aoll1r.fsf@gmail.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit 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=1626353838; 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=FjifmCGQW9LUOKurr96uv7eIUS6E2NabpOo3tM/vaWY=; b=D2iwnxOMSp1SUEHJsEetbzAYYbsFwPTAoety4XbuBUy5ilS1JhXypnmIwf36TUNyZ+O6sd w15Fkst/754ExneFgF0FU0hnbsZJFhXxqBAGIN8L8hO4UR3OwDjXdDpqRUAqqyPOiGbvlx 3NPeCt3HR9gyFgq/SJG+jEIObV8R1enRdfKBMVGcBWQ2nDBVXsgY/pUd7kQHHKR4ELdnMn 3KFAbfsx8jnega96WzFnsIq/JHBdusAaD59IRU7Z7KAjclzYSuT3eIdD+o5AiJhgSIQF7Z 6seQB0A3ko+O/lBV8OQV+bTEsSccvdhG8LgTQdOyA8mwGIQHvb1Jvgb3dyvuvQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1626353838; a=rsa-sha256; cv=none; b=Fc6sojFkR98JpUf5OrbHxVyBjNvKs9aw5b0pnDW1iMtd7w+dyDJO3SKG2OpfFCP5rgbk/G /6Rmr1xP/K3QD3XI12nsgxr5Fg48AplewaIL8zlL3J8W1dyiRUPfS7hNwXmeX+B9rUAXWB b/Au8ELz8QlAfVMWpA4giUtwUiKlClzUsT+el7NEq3zDUUxP/ETl863cRS6P+CmR35oay1 xFBj5X7TwGqGjCwJMp1LquOZdJYge52vXFikjw8Ai2jbhpMDClLNl1QPDOfK2Ya1S6lWRZ 1195FISzcghwGoy9KqAQvWa566hH7YYJsraVXeSkZ/NhuLaCR1Z/e7W4+HHdAg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=riseup.net header.s=squak header.b=J0BFnoz6; 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=riseup.net header.s=squak header.b=J0BFnoz6; 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: E926998BC X-Spam-Score: -1.30 X-Migadu-Scanner: scn0.migadu.com X-TUID: B0pxetlFDdLh > Could you propose a concrete wording solving > the issues you see Not really because english is not my mother tongue so there going to be errors in grammars, choosing of words..etc so better to be written by someone who has better english than me. But for the commands to go on step by step i can give that with little text and any webadmin can pick it up and arrange it accordingly. If guix documentation built on wikimedia it would be much easier because i can register and upload my changes and can be reviewed and updated, But using email for this is not the best way to achieve it but what to do.. zimoun: > 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 >