From patchwork Mon Aug 31 20:47:53 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Ludovic_Court=C3=A8s?= X-Patchwork-Id: 23844 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id DFDE227BBE7; Mon, 31 Aug 2020 21:49:09 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL autolearn=unavailable autolearn_force=no version=3.4.2 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 71CA627BBE6 for ; Mon, 31 Aug 2020 21:49:09 +0100 (BST) Received: from localhost ([::1]:41972 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kCqjk-0002SU-Ft for patchwork@mira.cbaines.net; Mon, 31 Aug 2020 16:49:08 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40822) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kCqjf-0002SF-1C for guix-patches@gnu.org; Mon, 31 Aug 2020 16:49:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:42312) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kCqje-000632-OE for guix-patches@gnu.org; Mon, 31 Aug 2020 16:49:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kCqje-00037h-Ni for guix-patches@gnu.org; Mon, 31 Aug 2020 16:49:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#43141] [PATCH 0/1] "Getting Started" section for the manual Resent-From: Ludovic =?utf-8?q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 31 Aug 2020 20:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 43141 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 43141@debbugs.gnu.org Cc: Ludovic =?utf-8?q?Court=C3=A8s?= X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.159890688711931 (code B ref -1); Mon, 31 Aug 2020 20:49:02 +0000 Received: (at submit) by debbugs.gnu.org; 31 Aug 2020 20:48:07 +0000 Received: from localhost ([127.0.0.1]:53855 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kCqil-00036N-Av for submit@debbugs.gnu.org; Mon, 31 Aug 2020 16:48:07 -0400 Received: from lists.gnu.org ([209.51.188.17]:49632) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kCqij-00036E-Ql for submit@debbugs.gnu.org; Mon, 31 Aug 2020 16:48:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40714) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kCqij-0002IB-J7 for guix-patches@gnu.org; Mon, 31 Aug 2020 16:48:05 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:34990) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kCqij-0005zk-9V; Mon, 31 Aug 2020 16:48:05 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=57846 helo=gnu.org) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kCqii-0003iy-Ls; Mon, 31 Aug 2020 16:48:05 -0400 From: Ludovic =?utf-8?q?Court=C3=A8s?= Date: Mon, 31 Aug 2020 22:47:53 +0200 Message-Id: <20200831204753.20291-1-ludo@gnu.org> X-Mailer: git-send-email 2.28.0 MIME-Version: 1.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches Hi Guix! Earlier today, a colleague of mine said they were giving Guix “a second chance” after an unsatisfying first attempt. They had successfully installed it, asked me about “that locale message from ‘guile’” and what’s going on with PATH and all, and told me they’d looked for “getting started” kind of material and didn’t find any. Indeed, a search for “guix getting started” in popular search engines yields nothing really useful. (I know we have getting-started videos on the front page, but for some reason they must not be that easy to find?) Anyway, it bothered me that the first-time user experience could be this bad, so I wrote this section for the manual. It’s designed to take at most 5mn to read and to have prominent boxes with commands to paste in a terminal. Perhaps it’s still even too long. What do you think, comrades? Ludo’. Ludovic Courtès (1): doc: Add "Getting Started" section. doc/guix.texi | 214 +++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 213 insertions(+), 1 deletion(-)