bug#65522: Documentation for some home services disappeared from 1.4 manual

[Simon Tournier]

Hi,

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

> https://guix.gnu.org/manual/en/html_node/File-Search-Services.html
> which is 404.

This webpage currently works for me.

> 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

bug#65522: Documentation for some home services disappeared from 1.4 manual

[Simon Tournier]

Hi,

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

> 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

bug#65522: Documentation for some home services disappeared from 1.4 manual

[nils]

> Simon Tournier  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
>  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.html open in a 
browser tab for more than a month, and on 2023-08-23 it was suddenly 404 
¯\_(ツ)_/¯

bug#65522: Documentation for some home services disappeared from 1.4 manual

[nils]

> Simon Tournier  hat am 05.09.2023 17:18 CEST 
> geschrieben:
> This webpage
>  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.html which 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!

bug#65522: Documentation for some home services disappeared from 1.4 manual

[Simon Tournier]

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


Cheers,
simon

bug#65522: Documentation for some home services disappeared from 1.4 manual

[nils]

Hello,

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.