Documentation is super important for complex things. I feel like it’s highly underrated by many otherwise great open source projects, to the severe detriment of the project. Nice to see an explicit focus on it.
Arch shares its wiki strategy with Debian
11–20 of 131 posts
Re: Arch shares its wiki strategy with Debian
#12Instead of creating multiple wikis with probably 80% of duplicate information between them, it would be great to have a cross distribution wiki with separate sections for distribution-specific instructions where it makes sense. Gentoo had a fantastic wiki before they lost it to disk array failure (IIRC) around ten years ago, now pretty much everyone is going to the Arch wiki, why not try to turn it into a shared proj…
Arch is essentially completely freeform; you, the user, are going to be making a lot of technical decisions on what you want your system to look like. It's perfectly okay for Arch to ship 4 different versions of the same type of tool, as long as all 4 are being used. The Arch wiki reflects this; it's focused around giving you a lot of options, while not going too in-depth on what you'd want to do with them. Want to swap out NetworkManager for wpa_supplicant because wpa_supplicant is easier to configure from a terminal? Perfectly fine, go ahead. Most arch packages as a result don't heavily deviate from upstream unless it's absolutely necessary to get them running.
Debian uh... isn't that. Debian still offers choice, but Debian has set the unenviable goal for themselves to provide a "stable" userland experience. This means Debian offers less options, but the options they do offer are also fixed on certain versions with sometimes pretty derivative versions compares to upstream. Their documentation as a result can get much more in-depth, just by virtue of having less to cover than Arch does.
A basic example here is setting up a webserver stack (so webserver, php and mysql); on Debian, you pick between apache2(+mod_php) or nginx/php-fpm and install mysql. Debian takes care of wiring all the permissions, user groups and all that stuff and giving you a "sane" default folder capable of serving PHP scripts on port 80 that anyone can use. It's a lot easier and nginx' configuration is specifically changed to resemble the apache2 vhosts. Arch doesn't do this; arch gives you the upstream versions of all these packages and then asks you to wire them together so that they work.
It means they attract pretty different audiences as a result; Debian users value stability/set and forget (also helped by Debian release cycles basically lasting the same length as most LTS releases of other distros), while Arch users are more conditioned to having to occasionally change their config files on updates.
That's also reflected in what their wikis aim at. Debian wikis generally can be version locked to their release; Arch wiki needs constant updating as things change.
They're different extremes here; most distros usually sit on one side or the other of this sorta thing (with the only real correlation being that dpkg-based distros usually lean more towards the Debian model), but there's also the pseudo-rolling release distros like Fedora, which try to offer similar stability to Debian but much shorter release cycles, so you'll always be running something at least close to the latest version.
Re: Arch shares its wiki strategy with Debian
#13Look at the "ArchWiki active users per month" graph. What happened in 2013? With the exception of the lockdown period, it has been decreasing since then.
Many people used Arch for its status as "the pro Linux distribution" i.e. not beginner friendly, but secretly still easy enough that you don't need much effort. That's how "I use Arch btw" became a meme. These people have now moved to NixOS.
Not many regrets aside from the times that I accidentally deleted my hard drives so many times that I can't count on fingers lol, its still a little fun lol. Ricing it with hyprland and I am truly happy with my system.
I also have nix but I couldn't really love it aside from the fact that nix-env is really really cool.
Re: Arch shares its wiki strategy with Debian
#14For lwn.net articles, aren't these subscriber-only links meant to be used only by the subscriber? Is sharing them on HN sabotaging lwn?
> Where is it appropriate to post a subscriber link?
> Almost anywhere. Private mail, messages to project mailing lists, and blog entries are all appropriate. As long as people do not use subscriber links as a way to defeat our attempts to gain subscribers, we are happy to see them shared.
Re: Arch shares its wiki strategy with Debian
#15For lwn.net articles, aren't these subscriber-only links meant to be used only by the subscriber? Is sharing them on HN sabotaging lwn?
Re: Arch shares its wiki strategy with Debian
#16For lwn.net articles, aren't these subscriber-only links meant to be used only by the subscriber? Is sharing them on HN sabotaging lwn?
Re: Arch shares its wiki strategy with Debian
#17I haven't even used Arch on any of my machines but can't count how many times I've found their wiki useful for my workstations, servers and even custom Yocto-built systems. Arch supports many ways of doing a thing, so whatever tool I'm dealing with, Arch probably supports that and documents it on the wiki. And Arch makes few changes from upstream so the wiki instructions are often applicable on any distro. Sure, it takes some familiarity to recognize when something is e.g. Debian-specific and should be done in a Debian way, but as a user fairly familiar with Linux, I often find Arch to be the best source of documentation.
Re: Arch shares its wiki strategy with Debian
#18Instead of creating multiple wikis with probably 80% of duplicate information between them, it would be great to have a cross distribution wiki with separate sections for distribution-specific instructions where it makes sense. Gentoo had a fantastic wiki before they lost it to disk array failure (IIRC) around ten years ago, now pretty much everyone is going to the Arch wiki, why not try to turn it into a shared proj…
Also, the whole sharing somehow seems to have died off over the decades. 25+ years ago, when wiki was new and shiny and everyone was experimental and motivated, there were strong movements for interwiki-content, sharing stuff between them openly. Then time happened, not much sharing was done, and every wiki-software slowly moved on, doing their own thing, becoming some semi-open silo or even a closed garden.
And today we had this same movement arising in the knowledge management-community, around their tools, and mainly in the context of Markdown, and it also kinda died down and never turned into anything substantial. Maybe, in the end, sharing information and knowledge is a bit harder to execute than it seems?
Re: Arch shares its wiki strategy with Debian
#19Instead of creating multiple wikis with probably 80% of duplicate information between them, it would be great to have a cross distribution wiki with separate sections for distribution-specific instructions where it makes sense. Gentoo had a fantastic wiki before they lost it to disk array failure (IIRC) around ten years ago, now pretty much everyone is going to the Arch wiki, why not try to turn it into a shared proj…
>why not try to turn it into a shared project?
This is basically both the highlight and the bane of the Linux world.
Why have another DE when there are already multiple ones? [0]
Why have another package manager when there are already multiple ones? [1]
Why have another distro when there are already multiple ones? [2]
So having another wiki makes perfect sense (or not depending on your POV)
0, https://en.wikipedia.org/wiki/Comparison_of_X_Window_System_...
1, https://en.wikipedia.org/wiki/List_of_software_package_manag...
Re: Arch shares its wiki strategy with Debian
#20Instead of creating multiple wikis with probably 80% of duplicate information between them, it would be great to have a cross distribution wiki with separate sections for distribution-specific instructions where it makes sense. Gentoo had a fantastic wiki before they lost it to disk array failure (IIRC) around ten years ago, now pretty much everyone is going to the Arch wiki, why not try to turn it into a shared proj…