install: rewrite and reorganize #415
Open
+252
−107
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This is a biggie.
The way we used the word "official" was incredibly nebulous and unclear to the average person to the point that I felt driven to rewrite the entire page. Now, we only use the word "official" to mean packages built and distributed by the Ghostty project itself, while trustworthy packages built by e.g. Linux distros are explicitly named as such.
A whole laundry list of changes:
Added the
ghostty-binpackage on Nixpkgs under macOS, plus an explanation of why we can't build Ghostty from source thereClarified that the Homebrew Cask and the
ghostty-binNix package are merely repackagings of the.dmg, and should be perfectly safe and trustworthyRenamed the "Linux (Official)" section to just "Linux", and the "Linux (Community)" section to "Linux (Community Binaries)"
Moved the instructions for using the AUR and the Nix flake to the "Prerelease Builds" page. That is the more logical place for them anyways, since an end user likely only uses them for building and installing tip releases
Added much more detailed instructions on how to use the Flake (you can't trust people to magically know this)
Added important caveats when it comes to running 3D-accelerated programs built with Nix on non-NixOS systems. It is so painfully common for people to install Ghostty on Nix on e.g. Fedora and then complain about how Ghostty fails to run there.
Added a much longer warning to using community binaries. For the sake of safety.
Fixed the links pointing to the Binary Releases page. If there's any I missed, let me know that I screwed up
Removed openSUSE (done in a separate commit so that if they ever un-drop us, we could simply revert the commit)