What do you think about merging both entries of the manual in the main menu of
the page and let it display a page in this vein:
NU Guix Reference Manual
This document is available in the following languages:
| language | current ("developer") | Version (1.3.) ("stable") |
|----------+---------------------------+------------------------------------|
| Deutsch |[[https://guix.gnu.org/manual/devel/de/html_node][HTML]],
[[https://guix.gnu.org/manual/devel/de/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/devel/de/guix.pdf][PDF]]
|[[https://guix.gnu.org/manual/de/html_node][HTML]],
[[https://guix.gnu.org/manual/de/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/de/guix.pdf][PDF]] |
| English |[[https://guix.gnu.org/manual/devel/en/html_node][HTML]],
[[https://guix.gnu.org/manual/devel/en/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/devel/en/guix.pdf][PDF]]
|[[https://guix.gnu.org/manual/en/html_node][HTML]],
[[https://guix.gnu.org/manual/en/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/en/guix.pdf][PDF]] |
| Español |[[https://guix.gnu.org/manual/devel/es/html_node][HTML]],
[[https://guix.gnu.org/manual/devel/es/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/devel/es/guix.pdf][PDF]]
|[[https://guix.gnu.org/manual/es/html_node][HTML]],
[[https://guix.gnu.org/manual/es/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/es/guix.pdf][PDF]] |
| français |[[https://guix.gnu.org/manual/devel/fr/html_node][HTML]],
[[https://guix.gnu.org/manual/devel/fr/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/devel/fr/guix.pdf][PDF]]
|[[https://guix.gnu.org/manual/fr/html_node][HTML]],
[[https://guix.gnu.org/manual/fr/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/fr/guix.pdf][PDF]] |
| русский |[[https://guix.gnu.org/manual/devel/ru/html_node][HTML]],
[[https://guix.gnu.org/manual/devel/ru/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/devel/ru/guix.pdf][PDF]]
|[[https://guix.gnu.org/manual/ru/html_node][HTML]],
[[https://guix.gnu.org/manual/ru/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/ru/guix.pdf][PDF]] |
| 中文 |[[https://guix.gnu.org/manual/devel/zh-cn/html_node][HTML]],
[[https://guix.gnu.org/manual/devel/zh-cn/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/devel/zh-cn/guix.pdf][PDF]]
|[[https://guix.gnu.org/manual/zh-cn/html_node][HTML]],
[[https://guix.gnu.org/manual/zh-cn/guix.html][HTML (single page)]],
[[https://guix.gnu.org/manual/zh-cn/guix.pdf][PDF]] |
* If you computer is already running Guix, running `info guix` is probably
the best way to read the current documentation
* If unsure, the "stable" documentation is probably not the one you are
looking for
* You might also want to download the
[[https://guix.gnu.org/guix-refcard.pdf][Guix reference card]]
* Or have a look at the cookbook, accessible via `info guix-cookbook` or
[[https://guix.gnu.org/cookbook/][online]].
It contains tutorials, how-to guides and examples contributed by the Guix
community which show you how to use the system and its collection of packages
to achieve common and not-so-common goals users may have.
* There is also a [[https://libreplanet.org/wiki/Group:Guix][wiki]] &
[[https://guix.gnu.org/en/videos/][videos]]
* If you need help, there are the IRC, the mailing lists and their archives
available at [[https://guix.gnu.org/en/contact/][guix.gnu.org/en/contact]]
?
Am I right in assuming that the stable version of the manual is only useful
before the first pull?
Is there a way to display the reference card on the system without grabbing the
pdf? And: it would be nicer if the orientation of the pages in the pdf was
rotated
Kind Regards,
Pascal
> On 17. Sep 2021, at 18:47, Tobias Geerinckx-Rice <m...@tobias.gr> wrote:
>
> Matthew Brooks 写道：
>> Thanks! I didn't realize there were two versions of the manual, and had been
>> checking the stable one.
>
> This state is extremely confusing and should be improved. How did you
> search/browse to the ‘stable’ manual?
>
> More generally: why did you end up loading a browser to look for the manual
> on the Web, instead of consulting the one on your Guix machine? Were you
> aware of it? Would you have seen a warning at the top of the page, or did
> you click straight through to a section/chapter? Consider this low-budget
> telemetry to find out how better to point users to other options ;-)
>
> Kind regards,
>
> T G-R
