-
Notifications
You must be signed in to change notification settings - Fork 428
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Improve Unclear Installation Instructions for Unix on Wiki - Include Major Package Managers #1520
Comments
I would like to second this request, and also add that the instructions that are included right now are also out of date. Not only do they specify an outdated tarball (it's easy to see that the latest at the current time of this writing is 3.9.2, and the instructions have you install 3.8.0), but also the (ETA: installing on Debian 12) |
@GECORegulatory A major problem with recommending downstream packages first in the upstream documentation is that those packages are often out-of-date. The Ubuntu packages for LuaRocks have been a major version behind for several years, and they are still out-of-date (3.8.0 vs 3.9.2) at the time I'm writing this. I think it's fair to assume users nowadays first attempt installing any package foobar by trying But yes, we could have separate sections or pages for "Installing from distribution packages" and "Building from source".
@rotemhacks Thanks for the heads up. This was contributed by the community, but hasn't been kept up to date. We shouldn't be keeping many places where the latest version number needs to be updated manually. Unfortunately we had to shut down freely editing the wiki due to spam and GitHub does not provide a way for people to make pull requests to the wiki. This has come up recently, and the only solution I could think of was plain old patches by email. |
Hello,
I have been going through the installation instructions for Unix systems on the Github Wiki and I found that it does not include information about package managers such as
apt
/dnf
. The current instructions focus on installing dependencies using these package managers, which could lead to confusion, especially those unfamiliar with package management in Unix-based systems. Typically, it is standard to include only build from source instructions if no other installation method is available. This is not the case anymore, and the documentation ofluarocks
should reflect this. The vast majority of users ofluarocks
do not need the additional functionality from building a bespoke configuration, so, in my opinion, this is an obvious choice to save user time and improve Lua Developer Experience, particularly for newer Lua devs.I've confirmed that
luarocks
is indeed available on major package managers like apt, and while I can't say for certain it is on DNF, I would assume so given it's presence on rpmfind. Considering this, it would be helpful to provide instructions that include installing Luarocks through these package managers, in addition to the existing method.This issue is low severity, as it only affects new installs.
Here's a proposed format:
Installing dependencies with apt/dnf (existing section)
Installing Luarocks with apt/dnf (new section)
Instructions for apt
Instructions for dnf (if verified)
[Additional sections for other distros/package managers]
Installing Luarocks manually (existing section)
Including these instructions would improve clarity and ease the installation process, especially for beginners.
Thanks for considering my suggestion.
The text was updated successfully, but these errors were encountered: