[bug#52596] [guix-artwork PATCH] website: Relabel stable/latest to release/current.

[zimoun]

Hi Florian,

On Sat, 18 Dec 2021 at 20:36, "pelzflorian (Florian Pelz)" 
<pelzflorian@pelzflorian.de> wrote:

> What matters is that users try first to install with the stable Guix
> System image, because it is more likely to succeed, but if it does not
> succeed, they can try the other one.  In this regard, the terms
> stable/latest seem fine to me.  1.3.0/current might reverse the order.

I agree with the aim.  I disagree with the term to express it and I
think that ’stable’ is not clear in this regard.  That’s why I proposed
’release’ instead, whereas I agree it is maybe not the best for
translation.

Well, maybe ’standard / latest’?  Or something else than latest as
development, current, or whatever else.


> On Sat, Dec 18, 2021 at 04:43:57PM +0100, zimoun wrote:
>> However, I have a strong opinion that this label stable/latest is
>> confusing, at least in the nav bar.  Especially if you come from other
>> distros.  For instance, stable never receives fixes, so it is not
>> 'stable' but 'frozen'.
>
> The discussion on IRC provess you right that users get confused.

I also see the same confusion here and there.  Often I answer that once
clicked, the download page explains what it is and thus one just has to
read to the difference.  That’s not true for the manual though.

Read explanation for something intuitive implies something is not
optimal, hence the proposed patch and discussion. :-)


>> Initially, I wanted to replace 'stable' by the current version number;
>> something using (latest-guix-version).  I think it is the best: clear
>> and easy to translate.  However, I had some hard time with all these
>> quote, backquote, unquote, so I gave up. :-)
>
> I agree that the "stable" manual is better described as 1.3.0 (like
> what your patch does) and not as stable.  But I am unsure if the
> stable manual is needed at all.  You have a more experienced judgment
> here though.

Well, keep the frozen manual for the current release is another
question.  For sure, I never use it and I never point to it.

I lack imagination and the only user-case I can think of is: read it
using another device while installing.

Therefore, maybe it would simplify if the navbar Help would contain only
“Guix Manual”.  And the navbar Download would contain Standard, where
the Standard webpage would contain a link for the manual in case it is
useful.

Instead of Standard, it could be (latest-guix-version) but I failed to
do it. :-)

 WDYT?


Cheers,
simon

Note that <https://www.gnu.org/manual/> points to
<https://www.gnu.org/software/guix/manual/>.