News for hackers. Stuff that matters.
Re:I Love Arch, but GNU Guix Is My New Distro by zelphirkalt on Saturday November 20, 2021 @06:27AM (#29287135)
Not sure what level exactly a beginner is, but I have my problems with Guix docs too. Try making a package for example. Took me a long time and multiple questions on mailing list and irc to get it done. People also recommend more than 1 different strategies. Then try upgrading a package, when there are some files you want to exclude. How to do that? Seems I can not find answers for my questions in the docs and always find myself asking on mailing list or irc. There people are helpful and mostly you get an answer. I like Guix as package manager, but their docs can definitely be improved with loads of examples and tutorials.
Re:I Love Arch, but GNU Guix Is My New Distro by masklinn on Saturday November 20, 2021 @06:42AM (#29287223)
> Not sure what level exactly a beginner is, but I have my problems with Guix docs too.

Oh don't get me wrong, I'm not saying guix is better (I have absolutely no idea), just that the experience with nix is extremely rough so nix being a bit more popular is not necessarily that much of an edge (or one at all).

> I like Guix as package manager, but their docs can definitely be improved with loads of examples and tutorials.

In fairness I'll say that especially if you're a long term user it is very easy to be blind to the early user experience. Sadly most projects don't push new users towards really reporting their experience or even contributing to the docs, but if you have the time and inclination to do so I'm quite convinced your experience would be extremely valuable to those who'll come after you, even if the project doesn't necessarily value them that much (but even then it can be useful as evidence of issues with the early experience / uptake, and possibly efforts to rectify them later on).

It's also useful on a personal level, because memory is a fickle thing and a year from now you may not even remember your struggles.

Re:I Love Arch, but GNU Guix Is My New Distro by zelphirkalt on Saturday November 20, 2021 @08:21AM (#29287832)
I wrote down all I learned here: https://notabug.org/ZelphirKaltstahl/gnu-guile-gnu-guix-pack... (or use org-mode file in same repo)

I've not yet had the energy or patience to learn the TexInfo format, which is a standard for GNU projects. But if anyone wants to put what I have in the Guix docs, even as merely an example or tutorial, I wont mind.

Re:I Love Arch, but GNU Guix Is My New Distro by pama on Saturday November 20, 2021 @11:00AM (#29289186)
Out of curiosity, did you try exporting from org mode? https://orgmode.org/manual/Texinfo-export-commands.html
Re:I Love Arch, but GNU Guix Is My New Distro by zelphirkalt on Saturday November 20, 2021 @12:15PM (#29289898)
I know that is possible, but I did not try, because I do not know, whether such an export would be a "drop-in-and-done" for the structure or nesting depth, if such things exist, in the actual documentation, or would have to be modified a lot to put in the docs.
Re:I Love Arch, but GNU Guix Is My New Distro by grumbel on Saturday November 20, 2021 @09:20AM (#29288282)
I found the easiest way to answer those questions is to look at how other packages do it.

The issue here isn't just that the documentation is lacking, but that Guix wants to have everything done in Scheme, so you often run into the issue of having to translate code you already have running in Bash into whatever Scheme equivalent Guix wants.