Link from download pages to install guides #7776
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
JDK 11 is no longer supported, so there is no reason to mention it as a disclaimer or a warning. Also adds an ID for debian-stable that can be used elsewhere.
The systemd instructions are more specific to Jenkins and more relevant to our readers. The DigitalOcean instructions were intended to persuade people that systemd is the right choice. Better to link to details that are specific to Jenkins.
Use most recent Debian 17 release.
Use the precise name of Red Hat Enterprise Linux and refer to the derivatives in the title rather than listing the derivatives. Include the names of key derivative operating systems in the body text so that search engines continue to find them. The Red Hat usage guidelines are very clear that they operating system is named Red Hat Enterprise Linux and should not be referenced as "Red Hat".
The pkg.jenkins.io site is the download site, but it is not the best site for installation instructiosn for Linux packages. Users of the Linux packages do not use a download URL. They use a series of steps that are specific to their operating system and its package manager. The link to the download site is a link to installation steps listed on pkg.jenkins.io. The installation steps on www.jenkins.io are more thorough and include specific instructions for Fedora Linux that are not available on pkg.jenkins.io Adds Fedora Linux as a seperate link in the list of packages because it intentionally has separate instructions for its `dnf` package manager. Red Hat Enterprise Linux 10 is planned to include the `dnf` package manager when it releases in mid-2025. When it releases, we'll need to revisit the instructions.
probot-autolabeler
bot
added
the
documentation
krisstern
approved these changes
Dec 23, 2024
timja
approved these changes
Dec 23, 2024
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Link from download pages to install guides
The pkg.jenkins.io site is the download site, but it is not the best site for installation instructions for Linux packages. Users of the Linux packages do not use a download URL. They use a series of steps that are specific to their operating system and its package manager. The link to the download site is a link to installation steps listed on pkg.jenkins.io. The installation steps on www.jenkins.io are more thorough and include specific instructions for Fedora Linux that are not available on pkg.jenkins.io
Adds Fedora Linux as a separate link in the list of packages because it intentionally has separate instructions for its
dnfpackage manager.Red Hat Enterprise Linux 10 is planned to include the
dnfpackage manager when it releases in mid-2025. When it releases, we'll need to revisit the instructions.Use broader description of RHEL and its derivatives
Use the precise name of Red Hat Enterprise Linux and refer to the derivatives in the title rather than listing the derivatives. Include the names of key derivative operating systems in the body text so that search engines continue to find them.
The Red Hat usage guidelines are very clear that they operating system is named Red Hat Enterprise Linux and should not be referenced as "Red Hat".
Update the Debian OpenJDK sample data
Use most recent Debian 17 release.
Link to our systemd instructions instead of DigitalOcean
The systemd instructions are more specific to Jenkins and more relevant to our readers. The DigitalOcean instructions were intended to persuade people that systemd is the right choice. Better to link to details that are specific to Jenkins.
Remove JDK 11 note for Debian 12
JDK 11 is no longer supported, so there is no reason to mention it as a disclaimer or a warning.
Also adds an ID for debian-stable that can be used elsewhere.
Review pages