Guix help page

Guix help page

[Vincent Legoll]

Hello,

I think we could add a link to the devel doc [1] (with the appropriate
warnings) to the "all help" page.

WDYT ?

[1] https://guix.gnu.org/manual/devel/

-- 
Vincent Legoll

Re: Guix help page

[Luis Felipe]

Hi Vincent,

On Sunday, April 18, 2021 4:59 PM, Vincent Legoll <vincent.legoll@gmail.com> wrote:

> Hello,
>
> I think we could add a link to the devel doc [1] (with the appropriate
> warnings) to the "all help" page.
>
> WDYT ?
>
> [1] https://guix.gnu.org/manual/devel/

It sounds good to me. I added this to my list, but if someone else wants to do it, please go ahead.

Re: Guix help page

[Vincent Legoll]

Hi,

On Mon, Apr 19, 2021 at 6:44 PM Luis Felipe
<luis.felipe.la@protonmail.com> wrote:
> It sounds good to me. I added this to my list, but if someone else wants to do it, please go ahead.

I'll give it a shot

-- 
Vincent Legoll

Re: Guix help page

[Vincent Legoll]

[-- Attachment #1: Type: text/plain, Size: 91 bytes --]

> I'll give it a shot

Here is an (untested) attempt, is it any good ?

-- 
Vincent Legoll

[-- Attachment #2: 0001-website-help-Add-development-manual-link.patch --]
[-- Type: text/x-patch, Size: 1019 bytes --]

From 50f15a322e86591bc6e3572245c98eb79c0dfafb Mon Sep 17 00:00:00 2001
From: Vincent Legoll <vincent.legoll@gmail.com>
Date: Mon, 19 Apr 2021 19:48:51 +0200
Subject: [PATCH] website: help: Add development manual link.

* website/apps/base/templates/help.scm (manual): Add development manual link.
---
 website/apps/base/templates/help.scm | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/website/apps/base/templates/help.scm b/website/apps/base/templates/help.scm
index 6eeb176..5179990 100644
--- a/website/apps/base/templates/help.scm
+++ b/website/apps/base/templates/help.scm
@@ -62,7 +62,11 @@ system|GNU Hurd|GNU Guix package manager|Help resources") #\|)
 
         ,(link-more
           #:label (G_ "Get Guix reference card")
-	  #:url (guix-url "guix-refcard.pdf")))
+	  #:url (guix-url "guix-refcard.pdf"))
+
+        ,(link-more
+          #:label (G_ "Read Guix manual (development versions)")
+          #:url (guix-url "manual/devel" #:localize #f)))
 
 
        (div
-- 
2.20.1

Re: Guix help page

[Luis Felipe]

On Monday, April 19, 2021 5:58 PM, Vincent Legoll <vincent.legoll@gmail.com> wrote:

> > I'll give it a shot
>
> Here is an (untested) attempt, is it any good ?

Personally, I would add the development version of the manual as a separate item in that page because the current Manual item already looks a bit crowded.

So I'd have one item titled "GNU Guix Manual X.Y.Z" and another one titled "GNU Guix Manual Latest" (or something like that). For the former, one can use the parameter "latest-guix-version" from the "(apps base utils)" module.

And I'd come up with appropriate summaries for both items.

Re: Guix help page

[Luis Felipe]

Hi,

On Monday, April 19, 2021 10:13 PM, Luis Felipe <luis.felipe.la@protonmail.com> wrote:

> On Monday, April 19, 2021 5:58 PM, Vincent Legoll vincent.legoll@gmail.com wrote:
>
> > > I'll give it a shot
> >
> > Here is an (untested) attempt, is it any good ?
>
> Personally, I would add the development version of the manual as a separate item in that page because the current Manual item already looks a bit crowded.
>
> So I'd have one item titled "GNU Guix Manual X.Y.Z" and another one titled "GNU Guix Manual Latest" (or something like that). For the former, one can use the parameter "latest-guix-version" from the "(apps base utils)" module.
>
> And I'd come up with appropriate summaries for both items.

I just sent a patch to add this (https://issues.guix.gnu.org/48187/).

Re: Guix help page

[Vincent Legoll]

Hello,

On Mon, May 3, 2021 at 4:11 PM Luis Felipe
<luis.felipe.la@protonmail.com> wrote:
> I just sent a patch to add this (https://issues.guix.gnu.org/48187/).

At a cursory glance, it LGTM.

Thanks a lot.

-- 
Vincent Legoll