From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id 0C18DUdiTV8lIwAA0tVLHw (envelope-from ) for ; Mon, 31 Aug 2020 20:49:11 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id qB5nCUdiTV/oVQAAbx9fmQ (envelope-from ) for ; Mon, 31 Aug 2020 20:49:11 +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 A71449403EC for ; Mon, 31 Aug 2020 20:49:10 +0000 (UTC) Received: from localhost ([::1]:41972 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kCqjl-0002SU-E3 for larch@yhetil.org; Mon, 31 Aug 2020 16:49:09 -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 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -3.3 (---) X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Spam-Score: 1.49 X-TUID: fSvS2KugsBw7 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(-) -- 2.28.0