GNU logs - #62160, boring messages

Message sent to bug-guix@HIDDEN:

Subject: bug#62160: Guix reference manual link from guix.gnu.org?
Resent-From: Simon Josefsson <simon@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-guix@HIDDEN
Resent-Date: Mon, 13 Mar 2023 12:13:02 +0000
Resent-Message-ID: <handler.62160.B.167870952423722 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 62160 <at> debbugs.gnu.org
Message-ID: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN>
From: Simon Josefsson <simon@HIDDEN>
Date: Mon, 13 Mar 2023 13:11:41 +0100
Content-Type: multipart/signed; micalg="pgp-sha256";
 protocol="application/pgp-signature"; boundary="=-sLNPLbi6EP4mmcKhxLx5"
User-Agent: Evolution 3.44.4-0ubuntu1 
MIME-Version: 1.0
Received-SPF: pass client-ip=2001:9b1:8633::107;
 envelope-from=simon@HIDDEN; helo=uggla.sjd.se
X-Spam_score_int: -43
X-Spam_score: -4.4
X-Spam_bar: ----
X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
 RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_PASS=-0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -1.4 (-)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.4 (--)

--=-sLNPLbi6EP4mmcKhxLx5
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Hi

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.

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/

  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.

2) Add links to the PDF variant and full-HTML variants in the top-right
menu where different languages are shown.

What do you think?  Then you quickly get into the manual, and there is
still a simple way to chose other languages, and to get PDF/full-HTML
variants.  I don't see any significant disadvantage with this change.

/Simon

--=-sLNPLbi6EP4mmcKhxLx5
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part

-----BEGIN PGP SIGNATURE-----

iHUEABYIAB0WIQSjzJyHC50xCrrUzy9RcisI/kdFogUCZA8S/QAKCRBRcisI/kdF
og5fAP0YLSfD35S5/PuD5Kd5fZqKPa2gzDt463l92NiH6fuEzAD/Uma2iDlXKIRq
xAiKuRMDqLcc1RBkVR/pkY5k+nXFtgU=
=Rau0
-----END PGP SIGNATURE-----

--=-sLNPLbi6EP4mmcKhxLx5--

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Simon Josefsson <simon@HIDDEN>
Subject: bug#62160: Acknowledgement (Guix reference manual link from
 guix.gnu.org?)
Message-ID: <handler.62160.B.167870952423722.ack <at> debbugs.gnu.org>
References: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN>
X-Gnu-PR-Message: ack 62160
X-Gnu-PR-Package: guix
Reply-To: 62160 <at> debbugs.gnu.org
Date: Mon, 13 Mar 2023 12:13:02 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-guix@HIDDEN

If you wish to submit further information on this problem, please
send it to 62160 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
62160: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D62160
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-guix@HIDDEN:

Subject: bug#62160: Guix reference manual link from guix.gnu.org?
Resent-From: Simon Tournier <zimon.toutoune@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-guix@HIDDEN
Resent-Date: Tue, 14 Mar 2023 11:30:02 +0000
Resent-Message-ID: <handler.62160.B62160.167879337127418 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Simon Josefsson <simon@HIDDEN>, 62160 <at> debbugs.gnu.org
From: Simon Tournier <zimon.toutoune@HIDDEN>
In-Reply-To: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN>
References: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN>
Date: Tue, 14 Mar 2023 12:29:11 +0100
Message-ID: <86h6un1shk.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

Hi Simon,

On Mon, 13 Mar 2023 at 13:11, Simon Josefsson via Bug reports for GNU Guix =
<bug-guix@HIDDEN> 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
<https://guix.gnu.org/en/manual/devel/en/guix.html>.

> 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---

<https://git.savannah.gnu.org/cgit/guix/guix-artwork.git/tree/website/apps/=
base/templates/components.scm#n417>

?

Cheers,
simon

Last modified: Tue, 14 Mar 2023 11:30:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.