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 ms0.migadu.com with LMTPS id ha62Gv2AWmEyswAAgWs5BA (envelope-from ) for ; Mon, 04 Oct 2021 06:20:13 +0200 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 4L+dFf2AWmHORQAAbx9fmQ (envelope-from ) for ; Mon, 04 Oct 2021 04:20:13 +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 E0A0FBEE7 for ; Mon, 4 Oct 2021 06:20:12 +0200 (CEST) Received: from localhost ([::1]:50666 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mXFSV-0007NH-My for larch@yhetil.org; Mon, 04 Oct 2021 00:20:12 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41428) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mXFSM-0007M7-Dy for bug-guix@gnu.org; Mon, 04 Oct 2021 00:20:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:51975) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mXFSM-0001Wc-5S for bug-guix@gnu.org; Mon, 04 Oct 2021 00:20:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mXFSL-0007b0-Sn for bug-guix@gnu.org; Mon, 04 Oct 2021 00:20:01 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#51000: The Web manual situation is still needlessly confusing References: <87ilydycps.fsf@nckx> In-Reply-To: <87ilydycps.fsf@nckx> Resent-From: John Kehayias Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Mon, 04 Oct 2021 04:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 51000 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: "51000@debbugs.gnu.org" <51000@debbugs.gnu.org> Received: via spool by 51000-submit@debbugs.gnu.org id=B51000.163332119529181 (code B ref 51000); Mon, 04 Oct 2021 04:20:01 +0000 Received: (at 51000) by debbugs.gnu.org; 4 Oct 2021 04:19:55 +0000 Received: from localhost ([127.0.0.1]:35288 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mXFSF-0007ab-Hm for submit@debbugs.gnu.org; Mon, 04 Oct 2021 00:19:55 -0400 Received: from mail-4322.protonmail.ch ([185.70.43.22]:50743) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mXFSC-0007aN-68 for 51000@debbugs.gnu.org; Mon, 04 Oct 2021 00:19:53 -0400 Date: Mon, 04 Oct 2021 04:19:41 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1633321185; bh=dnvu3mRvhKucMdu9a21bu3Shg1wgwxOBptOYEWGZ9dk=; h=Date:To:From:Reply-To:Subject:From; b=UbmS2yE5KGs99X0F/5rWnok1gCks83EWtmWsa0GsYnKRLcFBusYMU/V51WulQ983s 3z8INF3WNOADeSgAqVBHYZ5Kmo/2WR2q6S+pgliq0CTA0pKiFULkGBGHoHeVNDWfIM GZSW1GZ1DANFYKwqWiTx4AQoDRRvR6vsu/2eIsQw= Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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: , Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" Reply-to: John Kehayias X-ACL-Warn: , John Kehayias From: John Kehayias via Bug reports for GNU Guix X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1633321213; h=from:from:sender:sender:reply-to: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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=dnvu3mRvhKucMdu9a21bu3Shg1wgwxOBptOYEWGZ9dk=; b=ZbIMd7jvEIt+cjL/57P2IKuLyH8l7EsUktRmug0HUDciJgWsvYgz4cSq5MPN/ADZaeJ8+X 1I6iyhX82Xfz4sqsO9eqhpMeT4wXiSyNQdw9beFIRdBtxmQ9uS/3uZwtWM4JfmN3B7p7bw yPZY8AC+2Zl8OKKBHetWpzxv3V5Xi+PnIBgDWETkvrsfnSgG8z+Ua3JryIlrQ1yq3ggikC tf1c9MhMrW6iz1l31bOiJEezybAgBZ2bqKnTBk2taDk7/upuWY/181Ymu3ZBGU5QkxYXNr hMs/67WQjIkmKjj3B7v5llB8lQG10S2bQb+mK6Oz9CN6yu81Ns1183y4kbnn4Q== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1633321213; a=rsa-sha256; cv=none; b=GJiIDt/uoOSQ8tH4upAJ1P71yt5vKdZwCGnTqZ889FiWo8FhfTzHPVP46I79EwhjSMvar7 DFYgFgOBwtp8SqPuNeAi8eZrZgEsi3rOKf8F3CzSPNMOrKZdjsaUuYh2GGtRI1gAy47dKx Np8ayZg3PgTjO+B8cpYiffVBfcMFUG66fzaaeLU5Uwb2fhuBgVh6/wBLYUCPLN87u7Vzz5 qeBwkPTayRx+Fv9Nt2g038woOhQXPNFOfWgbR2H+5BJKxjQKesINWNkiZClk0Y/rF415Mr +IGEc6JSJ1BhOpCxL0xsvnOu5BA6gR1nj07r6K6CLWP+ES6N7Egxis1I97VMng== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=protonmail.com header.s=protonmail header.b=UbmS2yE5; 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: -2.91 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=protonmail.com header.s=protonmail header.b=UbmS2yE5; dmarc=pass (policy=none) header.from=gnu.org; 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: E0A0FBEE7 X-Spam-Score: -2.91 X-Migadu-Scanner: scn0.migadu.com X-TUID: iZRJLd67krcT Hi everyone, Definitely agree with needing this to be clearer than it is currently. As a= new user I was a bit confused over the different manual versions on the we= bsite (which is still how I prefer to read the manual). As a side note, whe= n searching online with Guix questions, I think I only see the 'stable' ver= sion come up in results. We could perhaps be clearer in what is meant by the 'stable'/1.3.0 document= ation. Seems this is mostly needed in preparing for installation (with the = 1.3.0 image, not if building a current install image, of course) and during= installation. Afterward, users will probably run a guix pull very soon (as= in Getting Started, or as recommended by the guix command itself) and thus= no longer be on the 1.3.0 manual. I'm not sure how best to communicate thi= s on the website, but to me it is related to the next point: I think we need something describing what we mean by Guix versions and rele= ases, perhaps in the Intro and/or Getting Started sections (and on an About= type page?). I was confused by this starting out, as I'm used to rolling d= istros like Arch (or, a long time ago, distros like Debian). While Guix is = mostly 'rolling', we also have releases with certain package changes (like = core-updates) and Guix changes. Just a simple description would I think hel= p new users and give better context for the manual versions, however we lab= el or make them available. I'm happy to take a stab and making either of these points clearer, especia= lly as one newer to Guix with these questions and assumptions nearer to min= d. John