bug#59277: Latest guix documentation - version number scrambled ?
I totally agree your more convulated solution.And thanks for the explanation, indeed.envoyé : 16 novembre 2022 à 10:06de : zimoun à : Sébastien FARGE , 59...@debbugs.gnu.orgobjet : Re: bug#59277: Latest guix documentation - version number scrambled ?Hi,On Tue, 15 Nov 2022 at 16:56, Sébastien FARGE wrote:>>> A consequence is that all links using the version number are broken.>>>>>> For exemple, on the page : https://guix.gnu.org/en/manual/devel/en/html_node/USB-Stick-and-DVD-Installation.html#Copying-to-a-USB-Stick>>>> Indeed, but the image is not built for each commit. Well, I do not know>> if it is fixable – or if it makes sense to fix. It is the devel manual>> after all. ;-)Does a documentation with broken links makes sense ?The point is that the (devel) manual is referring to some release only URLs: https://ftp.gnu.org/gnu/guix/The images there are only updated when a new release is out. It is nota rolling-release URL updated by the CI but a very stable URL manuallyupdated (I guess).This URL in the manual is generated by@indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso},where VERSION is from version.texi generated at compile-time, IIRC.The simplest is to add a warning note mentioning the issue and pointing to: https://guix.gnu.org/en/download/latest/A more convoluted solution would to introduce another version label asRELEASE-VERSION and use it in these places in the manual.Cheers,simon
bug#59277: Latest guix documentation - version number scrambled ?
Hi,
On Tue, 15 Nov 2022 at 16:56, Sébastien FARGE
wrote:
>>> A consequence is that all links using the version number are broken.
>>>
>>> For exemple, on the page :
>>> https://guix.gnu.org/en/manual/devel/en/html_node/USB-Stick-and-DVD-Installation.html#Copying-to-a-USB-Stick
>>
>> Indeed, but the image is not built for each commit. Well, I do not know
>> if it is fixable – or if it makes sense to fix. It is the devel manual
>> after all. ;-)
>
> Does a documentation with broken links makes sense ?
The point is that the (devel) manual is referring to some release only URLs:
https://ftp.gnu.org/gnu/guix/
The images there are only updated when a new release is out. It is not
a rolling-release URL updated by the CI but a very stable URL manually
updated (I guess).
This URL in the manual is generated by
@indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso},
where VERSION is from version.texi generated at compile-time, IIRC.
The simplest is to add a warning note mentioning the issue and pointing to:
https://guix.gnu.org/en/download/latest/
A more convoluted solution would to introduce another version label as
RELEASE-VERSION and use it in these places in the manual.
Cheers,
simon
bug#59277: Latest guix documentation - version number scrambled ?
Does a documentation with broken links makes sense ?I don't have the answer...envoyé : 15 novembre 2022 à 15:45de : zimoun à : Sébastien FARGE , 59...@debbugs.gnu.orgobjet : Re: bug#59277: Latest guix documentation - version number scrambled ?Hi,On lun., 14 nov. 2022 at 11:36, Sébastien FARGE wrote:On the front page (https://guix.gnu.org/en/manual/devel/fr/) theversion number is replaced by a strange number 'e26b529'.This is the commit against which the documentation had been built.A consequence is that all links using the version number are broken.For exemple, on the page : https://guix.gnu.org/en/manual/devel/en/html_node/USB-Stick-and-DVD-Installation.html#Copying-to-a-USB-StickIndeed, but the image is not built for each commit. Well, I do not knowif it is fixable – or if it makes sense to fix. It is the devel manualafter all. ;-)i failed to download the iso image named : https://ftp.gnu.org/gnu/guix/guix-system-install-e26b529.x86_64-linux.iso’Specifically, the images are updated for each release, only.For the latest images, please see: https://guix.gnu.org/en/download/latest/Cheers,simon
bug#59277: Latest guix documentation - version number scrambled ?
Hi, On lun., 14 nov. 2022 at 11:36, Sébastien FARGE wrote: > On the front page (https://guix.gnu.org/en/manual/devel/fr/) the > version number is replaced by a strange number 'e26b529'. This is the commit against which the documentation had been built. > A consequence is that all links using the version number are broken. > > For exemple, on the page : > https://guix.gnu.org/en/manual/devel/en/html_node/USB-Stick-and-DVD-Installation.html#Copying-to-a-USB-Stick Indeed, but the image is not built for each commit. Well, I do not know if it is fixable – or if it makes sense to fix. It is the devel manual after all. ;-) > i failed to download the iso image named : > https://ftp.gnu.org/gnu/guix/guix-system-install-e26b529.x86_64-linux.iso’ Specifically, the images are updated for each release, only. For the latest images, please see: https://guix.gnu.org/en/download/latest/ Cheers, simon
bug#59277: Latest guix documentation - version number scrambled ?
Hello guix team,Looks like there is a bug in latest online guix documentation.On the front page (https://guix.gnu.org/en/manual/devel/fr/) the version number is replaced by a strange number 'e26b529'.A consequence is that all links using the version number are broken.For exemple, on the page : https://guix.gnu.org/en/manual/devel/en/html_node/USB-Stick-and-DVD-Installation.html#Copying-to-a-USB-Sticki failed to download the iso image named : https://ftp.gnu.org/gnu/guix/guix-system-install-e26b529.x86_64-linux.iso’I also noticed that this number change from day to day.Thanks.
