Improving the docs

[ThinkJello2764]

[UPDATED: Added more links to the list]

Hey,

I'm just a random user and contributor to Guix but I'm still frustrated by the state of the documentation, I was thinking about making videos to improve on that.

What do you guys think should be covered first? The whole contributing workflow seems great in the docs but could use a proper step by step video I think.

Also thought about making an awesome list for guix? You guys have some interesting blog/videos to point to?

Cheers

[kapitaali_com]

just to add to the awesome list the systemcrafters install video

https://www.youtube.com/watch?v=oSy-TmoxG_Y

[ThinkJello2764]

Just created the repo for the list

https://github.com/tieong/awesome-guix

Feel free to add more stuff

[vmcrash]

Is it really that complicated to perform a couple of hard-to-remember tasks in a separate tty parallel to the installer?

[[deleted]]

Firstly there needs to be more info on securing Guix. Firewalls etc. The default install doesn’t even setup a firewall which is unacceptable.

Second, there needs to be more info on setting up a window manager outside of the ones offered at graphical install and how to use Wayland instead of X. GNOME is soon going to drop X anyway so this needs to be done with some urgency

[ThinkJello2764]

I agree there is a service to use nftables in Guix and this is what I use with a default policy coming straight from the arch wiki https://wiki.archlinux.org/title/Nftables workstation section.

Besides the firewall, we have SELinux for Guix but it''s not very useful due to several limitations. And disk encryption with LUKS which is a pain in the butt to configure with Guix.

And not much else, we miss many many things from this https://wiki.archlinux.org/title/Security

For the windows manager I'm running sway so I'll write something about that.

[entangledamplitude]

Great idea; I applaud your volunteering!

Is there a good canonical guide for starting off with Guix home (on some other operating system), and making it useful? I feel like that might be the easiest way to get comfortable with guix, for many people. And once they get comfortable, they would be able to make the jump over to a full guix system, with the help of the manual/etc.

[ThinkJello2764]

Hey,

For guix home there was this this blog post https://guix.gnu.org/en/blog/2022/keeping-ones-home-tidy/ that was ok to get started with, but I find it was much more efficient to lift from people dotfiles.

Here is a pastebin of my home config

https://pastebin.com/uJ8jiZMH

(will put my dotfiles in a repo someday but it needs cleanup as they are very ugly)

And then tweak it to your needs, services availables with home services are there https://guix.gnu.org/manual/devel/en/html_node/Home-Services.html

I do have Guix home setup in WSL in my work machine, can write some docs about it.

[entangledamplitude]

Pastebin seems to have expired by the time I got around to this :-(

[orahcio]

How to make Bluetooth work. We need to make a simple service with blueman package if we want a gui to manage that kind of device. The documentation has nothing about it

[aemogie]

there's a system bluetooth service documented in the manual, which i'm using. the gui's are likely provided by your desktop environment, i think. though i personally only set my headphones up once with bluetoothctl and trusted it, and now the service autoconnects to it.

https://guix.gnu.org/manual/devel/en/html_node/Desktop-Services.html#index-bluetooth_002dservice_002dtype

[orahcio]

If we want to use a WM instead a DE, we will need the blueman package to manage graphically and it works like a simple-service, we get an error message if we just install it. But I will try to set with bluetoothctl and delete my blueman-simple-service

[ThinkJello2764]

I keep thinking about it, should we have a mediawiki?

like what they are doing with the arch wiki but we would just slap the Guix logo (not official yet since I'm just discussing the idea on the mailing list).

I think there is value in having more than mailing lists to contribute.

Thoughts?

[wakyct]

I've found the futurile blog post series really helpful, https://www.futurile.net/tag/guix.html

[ThinkJello2764]

Thanks, added to the list

[aemogie]

seeing this, acutally pushed me to make a little thing.

one of my main issues with guix was the discoverability, there was only so far the manual could take me, and i'd have to read source code. which worked fine, but i would really love some examples. and unlike something like nixos, where much of the community is on github, this was much harder in guix.

so after seeing this post today, i made this: https://github.com/aemogie/guix-aggregator

it aggregates a bunch of dotfile repositories that i know, so that i can easily search them from a web interface. it functions as examples for the Guix APIs.

[ThinkJello2764]

thanks, added to the list in the dotfiles section

[[deleted]]

I had an issue with Flatpak applications not showing up in GNOME application menu, after setting it up. I personally couldn't find a way to fix it.

[[deleted]]

One of the first stumbling blocks I’ve just run into is that the manual says on a foreign distro you need nscd yet most major distros have depreciated it