From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id qJ/pD8laEGSdwQAASxT56A (envelope-from ) for ; Tue, 14 Mar 2023 12:30:17 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id lkTwDslaEGRPuAAAG6o9tA (envelope-from ) for ; Tue, 14 Mar 2023 12:30:17 +0100 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 E10B638BF0 for ; Tue, 14 Mar 2023 12:30:16 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pc2r1-000605-HM; Tue, 14 Mar 2023 07:30:07 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pc2qx-0005wg-0u for bug-guix@gnu.org; Tue, 14 Mar 2023 07:30:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pc2qw-0001VR-Ne for bug-guix@gnu.org; Tue, 14 Mar 2023 07:30:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pc2qw-00079E-61 for bug-guix@gnu.org; Tue, 14 Mar 2023 07:30:02 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#62160: Guix reference manual link from guix.gnu.org? Resent-From: Simon Tournier Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Tue, 14 Mar 2023 11:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 62160 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: Simon Josefsson , 62160@debbugs.gnu.org Received: via spool by 62160-submit@debbugs.gnu.org id=B62160.167879337127418 (code B ref 62160); Tue, 14 Mar 2023 11:30:02 +0000 Received: (at 62160) by debbugs.gnu.org; 14 Mar 2023 11:29:31 +0000 Received: from localhost ([127.0.0.1]:36487 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pc2qQ-00078A-Hg for submit@debbugs.gnu.org; Tue, 14 Mar 2023 07:29:30 -0400 Received: from mail-wr1-f45.google.com ([209.85.221.45]:42852) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pc2qO-00077x-Nm for 62160@debbugs.gnu.org; Tue, 14 Mar 2023 07:29:29 -0400 Received: by mail-wr1-f45.google.com with SMTP id j2so13988969wrh.9 for <62160@debbugs.gnu.org>; Tue, 14 Mar 2023 04:29:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1678793363; x=1681385363; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=Buap+rZOFuKlj41hsAVzvwRTaMJvawRhmWvOuOFVmKU=; b=ZFSjgX62a4NR2tbzJY1KLuGLVXSo02xrL9ITkzOJluSIfMLEVWx81oM0d3ipQ0z5nl jCPX0XdV2THRUuCYEHFuVnMS6vcOtrS6amIBM+1IXm17LhdJai00WnCjba3OLzEId+d1 D4icoEMoujtRSQDx44kdx1iA61Fb0DRNDPPWUY44nP7L8H8EvVzY4Q1rS4Nioj4varCO BtBuQKEg9PG/iz6sNMzsJFg2mQfgGok/FmYWbLRYB11nPivWIAdfrzy0MOKBVklVSnlo n6nu/XP7N6H3RWkBErWHS4mW5l3Nipck9K+L03iBjii6O31QXLxG107ndJsyq2Ig01Bh 8+6A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1678793363; x=1681385363; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:to:from:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to; bh=Buap+rZOFuKlj41hsAVzvwRTaMJvawRhmWvOuOFVmKU=; b=dzJnQAt9fde1l3sZKHcRjqlNyY/2S6AG7UC246i9PfrbNffZ0pzVB2Np+XbB9Ma9VX R/tz0aLKCgF97mwIfhL5kkSsYHPEDI6MEz82ZnqmgTE2wk5pV+vCGLat+NBr3ZS/gp/N JyUvMYFLLkjk55U60QxK/Ds8siwz8GUFNnURTWrFE2DY/z/yTAt8sY4l27Ufri3L1PQL LRTcU5xl2QDwPhVdejBl1nNdV8QcUNGbTDTlNt6j/N2fo6ZjsptZMowtZIyZZddwS7JH FgpXqUzkk9UThDROtd/TvgARGsEx2G78tan8Tu7mjAAW695h6Gl2qHnX7pbNIX6QfpS6 4I1Q== X-Gm-Message-State: AO0yUKWG6P1WnOqwfZEmuM7fe50lA+XQqrbEVYRd+Pwshy3TLzw16ih6 sAGytPeAArTpJX5U9EoMBIqbmQOVxp4= X-Google-Smtp-Source: AK7set+xEROBVaMfaEj7p0cJdJRkeBb9+QXb4Ixc/8BlkI3B4a/en9bvpz3lqUQ26RB0wEwseXCMYw== X-Received: by 2002:a5d:434d:0:b0:2c7:1c4e:1d16 with SMTP id u13-20020a5d434d000000b002c71c4e1d16mr8832058wrr.0.1678793362739; Tue, 14 Mar 2023 04:29:22 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id w7-20020adfd4c7000000b002c557f82e27sm1866413wrk.99.2023.03.14.04.29.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 14 Mar 2023 04:29:22 -0700 (PDT) From: Simon Tournier In-Reply-To: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@josefsson.org> References: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@josefsson.org> Date: Tue, 14 Mar 2023 12:29:11 +0100 Message-ID: <86h6un1shk.fsf@gmail.com> 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=ZFSjgX62; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Seal: i=1; s=key1; d=yhetil.org; t=1678793417; a=rsa-sha256; cv=none; b=t9jqrut9l4BQe4Rohx6pZf8AI3HchQnWWs6VmCN48nRAFsWQmlkFpA3IGkByCAfiWCUx8y ehlRvQGYQoHC2qvUO0VICQg3Biw91BbgBlqLL12wQbZPrgg+AA7Kaq+Yhw0LbSvA4X74Lr 2IDJQs4tr56fh+NcvDELhjhtXhHnl+Gvb02C38FH251FKoCMtK3pd4Iy+5FIUWuN0xPZJj pqU2sk4JeoUpFyouyqMfSVTltd/XnKir9VbCIH3GJQKT4dGeyWs+uIgArboYo/M4DK67e3 KlKcIZnoPiIhqPYdKw+AEAf08bcVY+j7+GRRNu0SBI6uZM9nFM8bIQjlicOLmQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1678793417; h=from:from:sender:sender: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=Buap+rZOFuKlj41hsAVzvwRTaMJvawRhmWvOuOFVmKU=; b=VsuO9TU3syxLlzdkdrZJ/wGrmHLaJvNp9m6kD5sPl0Qk09WMNjB4AAVG+JCKR6VeuPCcyS fSL8nwW1LpYyIrAtQ6vEzoDL2aqc3h35EGYqPNHQsaasm72wNzmiKgpt+njdF8jDtjfp3P xfyH71AZBXDb6qaTQ+Kz8b0cqE+XfIsnLWSSdMj20XNACxQmCbygMXLBvDzPHY9Qkm1BS+ i9qnRi7Tk3ek0pcQq+biY/4CLe5R6vz55epU/nTGbjM7gJcr5ussAwDOGYhQ2ksa7DDzPq YNIk/f6Zyyi/e+ze+Sus/V871EWrvN2A5Qgos2m3oygGULxwop6ysgV0lxVzuA== X-Migadu-Spam-Score: -1.12 X-Spam-Score: -1.12 X-Migadu-Queue-Id: E10B638BF0 X-Migadu-Scanner: scn1.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=ZFSjgX62; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none) X-TUID: Fa+I2cpToUnv Hi Simon, On Mon, 13 Mar 2023 at 13:11, Simon Josefsson via Bug reports for GNU Guix = wrote: > I often go to guix.gnu.org to read the (excellent!) Guix manual. This > leads to this click pattern: guix.gnu.org -> Help -> GNU Guix Manual > 1.4.0 which leads me to a page (written in english) to chose language > of the manual -- https://guix.gnu.org/en/manual/ -- and when I chose > English I get a page to chose format of manual -- > https://guix.gnu.org/en/manual/en/ -- and that choice takes a split > second cognitive load. Well, personally I never read en/manual/ but always en/manual/devel/. :-) And I have a short-cut (or bookmark) for opening . > How about these changes to improve user experience? > > 1) The link guix.gnu.org -> Help -> GNU Guix Manual 1.4.0 goes directly > to the split-node https://guix.gnu.org/en/manual/en/html_node/ Well, I do not have an opinion since I barely read released manual but only the more accurate devel manual. However, my preference is about =E2=80=99entirely on one page=E2=80=99 an n= ot =E2=80=99with a separate page per node=E2=80=99 because =E2=80=99entirely on one page=E2=80= =99 eases Control-f for searching. :-) > 1b) The link could respect the language-choice for the web-site, > i.e., so if I'm browsing https://guix.gnu.org/de/ it should directly > link me to https://guix.gnu.org/de/manual/de/html_node/ instead. With this change, where can I choose the language for the manual? The workflow would be, From https://guix.gnu.org/ Click top right to language and select one, say French Then click Aide -> Manuel and it would open the manual in French. so I would have to come back the front page to switch from one language to the other. Right? Well, in addition, I would like to have a page proposition the manual for all the languages, as we have now. For example, these two webpages: https://guix.gnu.org/en/manual/devel/ https://guix.gnu.org/fr/manual/devel/ serve the same choice and I would like to keep it somewhere. > 2) Add links to the PDF variant and full-HTML variants in the top-right > menu where different languages are shown. Do you mean add an item to the list, --8<---------------cut here---------------start------------->8--- ,(menu-dropdown #:label (C_ "website menu" "Help") [...] (menu-item #:label "All" [...] (menu-item #:label (C_ "website menu" (string-append "GNU Guix Manual " [...] (menu-item #:label "GNU Guix Manual (latest)" [...] (menu-item #:label "Guix Reference Card" [...] (menu-item #:label "Videos" [...] (menu-item #:label "Cookbook" [...] (menu-item #:label "GNU Manuals" [...] (menu-item #:label "Wiki" [...] (menu-item #:label "IRC Chat" [...] (menu-item #:label "Mailing Lists" --8<---------------cut here---------------end--------------->8--- ? Cheers, simon