From debbugs-submit-bounces@debbugs.gnu.org Mon Oct 04 00:19:55 2021 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= To: "51000@debbugs.gnu.org" <51000@debbugs.gnu.org> From: John Kehayias Subject: Re: The Web manual situation is still needlessly confusing Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 51000 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: John Kehayias Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) 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