Documentation for some home services disappeared from 1.4 manual

  • Done
  • quality assurance status badge
Details
2 participants
  • nils
  • Simon Tournier
Owner
unassigned
Submitted by
nils
Severity
minor
N
(name . bug-guix@gnu.org)(address . bug-guix@gnu.org)
944365132.479318.1692944188112@office.mailbox.org
Hello,

I noticed some help nodes under https://guix.gnu.org/en/manual/en/html_node/Home-Services.htmldisappeared fairly recently.
They are still available in the devel docs under https://guix.gnu.org/en/manual/devel/en/html_node/Home-Services.html

The following topics are missing:
* GPG: GNU Privacy Guard. Setting up GPG and related tools.
* Fonts: Fonts Home Services. Services for managing User's fonts.
* Sound: Sound Home Services. Dealing with audio.
* Mail: Mail Home Services. Services for managing mail.
* Messaging: Messaging Home Services. Services for managing messaging.
* Media: Media Home Services. Services for managing media.
* Networking: Networking Home Services. Networking services.
* Miscellaneous: Miscellaneous Home Services. More services.

This makes sense when looking at the 1.4.0 git tag, but I had a browser tab open, and https://guix.gnu.org/manual/en/html_node/Mail-Home-Services.htmlwas definitely available just a day or two ago.

I don't know if this is actually an issue or an intended change, but it seemed better to report it than to ignore it.
S
S
Simon Tournier wrote on 5 Sep 2023 17:18
86tts8sl6i.fsf@gmail.com
Hi,

On Fri, 25 Aug 2023 at 08:16, nils@landt.email wrote:

Toggle quote (17 lines)
> I noticed some help nodes under https://guix.gnu.org/en/manual/en/html_node/Home-Services.htmldisappeared fairly recently.
> They are still available in the devel docs under https://guix.gnu.org/en/manual/devel/en/html_node/Home-Services.html
>
> The following topics are missing:
> * GPG: GNU Privacy Guard. Setting up GPG and related tools.
> * Fonts: Fonts Home Services. Services for managing User's fonts.
> * Sound: Sound Home Services. Dealing with audio.
> * Mail: Mail Home Services. Services for managing mail.
> * Messaging: Messaging Home Services. Services for managing messaging.
> * Media: Media Home Services. Services for managing media.
> * Networking: Networking Home Services. Networking services.
> * Miscellaneous: Miscellaneous Home Services. More services.
>
> This makes sense when looking at the 1.4.0 git tag, but I had a browser tab open, and https://guix.gnu.org/manual/en/html_node/Mail-Home-Services.html was definitely available just a day or two ago.
>
> I don't know if this is actually an issue or an intended change, but it seemed better to report it than to ignore it.

I am sorry, I am not sure to understand what the bug is about. :-)

This webpage
to the manual as it was for the last release. It means, this manual
wepage is frozen and is only updated at each release. If you have seen
something different, it is an artifact that should not be possible.

For instance, the service

* GPG: GNU Privacy Guard. Setting up GPG and related tools.

had been added on Sat Apr 8 22:56:19 2023 +0200 which is after the
release 1.4.0.

There is no bug and I am favor to close it. WDYT?


Cheers,
simon
S
S
Simon Tournier wrote on 5 Sep 2023 17:18
control message for bug #65522
(address . control@debbugs.gnu.org)
86sf7ssl6e.fsf@gmail.com
tags 65522 + moreinfo
quit
N
Re: bug#65522: Documentation for some home services disappeared from 1.4 manual
610495369.340893.1693986082059@office.mailbox.org
Toggle quote (41 lines)
> Simon Tournier <zimon.toutoune@gmail.com> hat am 05.09.2023 17:18 CEST geschrieben:
>
>
> Hi,
>
> On Fri, 25 Aug 2023 at 08:16, nils@landt.email wrote:
>
> > I noticed some help nodes under https://guix.gnu.org/en/manual/en/html_node/Home-Services.html disappeared fairly recently.
> > They are still available in the devel docs under https://guix.gnu.org/en/manual/devel/en/html_node/Home-Services.html
> >
> > The following topics are missing:
> > * GPG: GNU Privacy Guard. Setting up GPG and related tools.
> > * Fonts: Fonts Home Services. Services for managing User's fonts.
> > * Sound: Sound Home Services. Dealing with audio.
> > * Mail: Mail Home Services. Services for managing mail.
> > * Messaging: Messaging Home Services. Services for managing messaging.
> > * Media: Media Home Services. Services for managing media.
> > * Networking: Networking Home Services. Networking services.
> > * Miscellaneous: Miscellaneous Home Services. More services.
> >
> > This makes sense when looking at the 1.4.0 git tag, but I had a browser tab open, and https://guix.gnu.org/manual/en/html_node/Mail-Home-Services.html was definitely available just a day or two ago.
> >
> > I don't know if this is actually an issue or an intended change, but it seemed better to report it than to ignore it.
>
> I am sorry, I am not sure to understand what the bug is about. :-)
>
> This webpage
> <https://guix.gnu.org/en/manual/en/html_node/Home-Services.html> points
> to the manual as it was for the last release. It means, this manual
> wepage is frozen and is only updated at each release. If you have seen
> something different, it is an artifact that should not be possible.
>
> For instance, the service
>
> * GPG: GNU Privacy Guard. Setting up GPG and related tools.
>
> had been added on Sat Apr 8 22:56:19 2023 +0200 which is after the
> release 1.4.0.
>
> There is no bug and I am favor to close it. WDYT?

If this is intended and expected, then feel free to close it, sure.
But it's certainly changed behaviour. I had https://guix.gnu.org/manual/en/html_node/Mail-Home-Services.htmlopen in a browser tab for more than a month, and on 2023-08-23 it was suddenly 404 ¯\_(?)_/¯
N
1729416148.370540.1693998965634@office.mailbox.org
Toggle quote (7 lines)
> Simon Tournier <zimon.toutoune@gmail.com> hat am 05.09.2023 17:18 CEST geschrieben:
> This webpage
> <https://guix.gnu.org/en/manual/en/html_node/Home-Services.html> points
> to the manual as it was for the last release. It means, this manual
> wepage is frozen and is only updated at each release. If you have seen
> something different, it is an artifact that should not be possible.

Note: I just searched for "guix search-input-file" on duckduckgo (and startpage / google to doublecheck) and the second hit was pointing to https://guix.gnu.org/manual/en/html_node/File-Search-Services.htmlwhich is 404. https://guix.gnu.org/manual/devel/en/html_node/File-Search-Services.html works.
So it appears the manual was wrong (=showing the "latest" version instead of 1.4.0) long enough to be indexed by search engines.
Of course this does not really change anything, if the current manual is correct then let's close this bug report!
S
S
Simon Tournier wrote on 7 Sep 2023 01:23
865y4mophb.fsf@gmail.com
Hi,

On Wed, 06 Sep 2023 at 09:41, nils@landt.email wrote:

Toggle quote (5 lines)
> But it's certainly changed behaviour. I had
> https://guix.gnu.org/manual/en/html_node/Mail-Home-Services.html open
> in a browser tab for more than a month, and on 2023-08-23 it was
> suddenly 404 ¯\_(?)_/¯

This webpage currently works. So you have probably seen a transient
issue.

Cheers,
simon
S
S
Simon Tournier wrote on 7 Sep 2023 01:26
861qfaopcj.fsf@gmail.com
Hi,

On Wed, 06 Sep 2023 at 13:16, nils@landt.email wrote:

Toggle quote (3 lines)
> which is 404.

This webpage currently works for me.

Toggle quote (3 lines)
> Of course this does not really change anything, if the current manual
> is correct then let's close this bug report!

Well, I am closing since it is probably a transient issue. Feel free to
reopen if you have similar troubles.

Cheers,
simon
Closed
?