That's because it's written by developers. Devs are generally really poor at explaining things and they rarely have enough empathy to even notice that "normal people" might not necessarily understand (or care) as to why would they be better off compiling software from source. It's a known problem: documentation writing is one of the most hated software engineering-related work. It's a self-defeating but prevalent notion that "you can just read the code, so why would I write the docs?" Also: "nobody reads the docs" -> "why would I put effort into writing something nobody reads?" -> the docs are bad (obviously) -> "nobody reads the docs"...
In this particular case: the docs here are really, really badly structured and the styles/colors/margins/etc make it even less readable. At least, however, the authors of the wiki try to be helpful:
> If you want an easy life, follow this community provided and maintained Easy Install script for a base Debian (Raspbian / Raspberry Pi OS) / Ubuntu install.
There's a link to the script below. That's already the best you can expect from developers who are not specifically paid to produce installers (or, alternatively, use a framework that generates the installers automatically). The vast majority of devs never consider that people would like to easily and quickly install their software to try it out, then uninstall it if it's not to their liking.
Also, why would you spend your time on an un-installer? If the user doesn't like their software, the devs assume it's the user's problem, not theirs. It's so irritating that I've set up automatic snapshots on /usr/ and /usr/local/ just to be able to easily get rid of stuff that ends up there with every `make install` I execute.
I know how it sounds - I'm not trying to justify this way of working on and with software, just thought I'll share what little insight I got after working with Linux-y things for two decades...
> The last time I booted up Ubuntu I couldn’t even adjust the mouse acceleration without spending 10 minutes on Google
It doesn't change anything, but I had a pretty horrible experience with Windows and MacOS drivers for Logitech trackballs[1][2]. While the setup on Linux took a few hours, included 3 different applications, 4 different config files, and dozens of man pages to read, it at least enabled me to actually get the most out of the hardware. It was utterly impossible to configure the trackballs to my liking under Windows. I didn't try very hard under MacOS, but the initial research suggested it's even worse there (Logitech seemed to be hell-bent on "Windows first, second, and last" policy for some reason).
> Users should never ever, for any reason ever, need to open the CLI.
Not sure I agree, not fully. Text-based interfaces have their place - they present very different trade-off between accessibility and convenience than GUIs do. There's a reason why the command prompt metaphor is still alive, 30+ years after the hardware got good enough to display a GUI on home computers. Though it's probably better left to people who want to use it, not people who are forced to use it; kind of like regedit.exe was always shipped with Windows, even though 99%[3] of users didn't (need to) know of its existence.
I understand this is the fault of the developer, but that's not my problem. I'm a consumer and I want my application to install in under 60 seconds like it does in Windows. Too many developers rely on the CLI in Linux, and this means that, too often, my Linux experience is much worse than my Windows experience. I don't care who is to blame. It just is.
>Though it's probably better left to people who want to use it, not people who are forced to use it; kind of like regedit.exe was always shipped with Windows, even though 99%[3] of users didn't (need to) know of its existence.
I agree. To be clear, the CLI has many benefits. It just has so few, comparatively, in the consumer space, and developers seem adamant to push consumers to use the CLI in Linux. For 99% of my use cases, everything is easier and faster in a GUI.
You already know the answer to this: if you don't like it, you should fix it! It's open source! In other words, the all too familiar blaming the victim.
It's silly, yes. Especially since there are at least 5 ways of making self-contained, one-file or single-directory distributions of software under Linux. Discord comes as a zip file that you need to unpack, then click on the "Discord" executable - and done. Joplin (my note-taking app choice) uses AppImage, where you download a single file and run it, done. It can be done. Yet, it's not done in the vast majority of cases.
You're not interested in reasons why it's not being widely adopted, so let me just talk to myself. Personally, I'd blame package managers. They are too good, too convenient, to the point that not using them is a real hassle. Those of us who remember the dependency hell won't give up package managers until death do us part. Yet, there are too many of them. Having 3 different pkg managers on a single system (deb, snap, flatpak) is sheer madness.
There's also obsession with dynamic linking combined with reluctance to bundle the required libraries with an app (because updates! we would need to actually track development and test new versions of libraries as they appear, who has time for that?!), and a few other problems. As a whole it's a societal problem that won't go away in the foreseeable future. It's also... not a bad problem to have. It guarantees a heavy push-back against app stores, at least.
I have used the Radarr and Sonarr Docker images for around 5 years now. Those were super easy to deploy -- so when I read this comment that the manual was ridiculous I didn't believe it.
Then I read the manual and it's totally true: this is some of the least user-friendly documentation I have ever seen! Terribly tough to follow.
That's because it's written by developers. Devs are generally really poor at explaining things and they rarely have enough empathy to even notice that "normal people" might not necessarily understand (or care) as to why would they be better off compiling software from source. It's a known problem: documentation writing is one of the most hated software engineering-related work. It's a self-defeating but prevalent notion that "you can just read the code, so why would I write the docs?" Also: "nobody reads the docs" -> "why would I put effort into writing something nobody reads?" -> the docs are bad (obviously) -> "nobody reads the docs"...
In this particular case: the docs here are really, really badly structured and the styles/colors/margins/etc make it even less readable. At least, however, the authors of the wiki try to be helpful:
> If you want an easy life, follow this community provided and maintained Easy Install script for a base Debian (Raspbian / Raspberry Pi OS) / Ubuntu install.
There's a link to the script below. That's already the best you can expect from developers who are not specifically paid to produce installers (or, alternatively, use a framework that generates the installers automatically). The vast majority of devs never consider that people would like to easily and quickly install their software to try it out, then uninstall it if it's not to their liking.
Also, why would you spend your time on an un-installer? If the user doesn't like their software, the devs assume it's the user's problem, not theirs. It's so irritating that I've set up automatic snapshots on /usr/ and /usr/local/ just to be able to easily get rid of stuff that ends up there with every `make install` I execute.
I know how it sounds - I'm not trying to justify this way of working on and with software, just thought I'll share what little insight I got after working with Linux-y things for two decades...
> The last time I booted up Ubuntu I couldn’t even adjust the mouse acceleration without spending 10 minutes on Google
It doesn't change anything, but I had a pretty horrible experience with Windows and MacOS drivers for Logitech trackballs[1][2]. While the setup on Linux took a few hours, included 3 different applications, 4 different config files, and dozens of man pages to read, it at least enabled me to actually get the most out of the hardware. It was utterly impossible to configure the trackballs to my liking under Windows. I didn't try very hard under MacOS, but the initial research suggested it's even worse there (Logitech seemed to be hell-bent on "Windows first, second, and last" policy for some reason).
> Users should never ever, for any reason ever, need to open the CLI.
Not sure I agree, not fully. Text-based interfaces have their place - they present very different trade-off between accessibility and convenience than GUIs do. There's a reason why the command prompt metaphor is still alive, 30+ years after the hardware got good enough to display a GUI on home computers. Though it's probably better left to people who want to use it, not people who are forced to use it; kind of like regedit.exe was always shipped with Windows, even though 99%[3] of users didn't (need to) know of its existence.
[1] https://support.logi.com/hc/en-us/articles/360025260314--Pro...
[2] https://www.logitech.com/en-us/products/mice/mx-ergo-wireles...
[3] Well, depending on an era and target demographic.