From 0c19148864526afd76d0fb18c3f8559e20ffd701 Mon Sep 17 00:00:00 2001
From: Carl George <carl@george.computer>
Date: Dec 03 2021 15:57:25 +0000
Subject: Rewrite quickstart


- Mention epel-next-release
- Clarify that some distros include release packages in their default repos
- List necessary commands together for each distro for easier copy/paste
- Add EL9 stuff
- Explicitly mention AlmaLinux and Rocky Linux

---

diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc
index 5e967fa..43d551f 100644
--- a/modules/ROOT/pages/index.adoc
+++ b/modules/ROOT/pages/index.adoc
@@ -10,41 +10,74 @@ Welcome to the home of the EPEL Special Interest Group.
 
 == Quickstart
 
-* https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm[epel-release-latest-7]
+We offer release packages containing our repository configuration files and public package signing keys.
+Use the version that corresponds to the major version of your operating system.
+
+* https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm[epel-release-latest-9]
 * https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm[epel-release-latest-8]
+* https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm[epel-release-latest-7]
+
+If you are using CentOS Stream, we also recommend installing the corresponding epel-next-release package.
+
+* https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-9.noarch.rpm[epel-next-release-latest-9]
+* https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-8.noarch.rpm[epel-next-release-latest-8]
+
+For convenience some distributions include these release packages in their default repositories,
+allowing you to install them by name without the full URL.
+
+Some EPEL packages depend on packages from repositories that are not enabled by default.
+Take note of the additional repositories being enabled in the following instructions.
+
+=== EL9
+
+==== CentOS Stream 9
 
-You may retrieve signed binary configuration files from one the above
-two links (varying by the major release number of the installation
-target machine). They may be automatically installed by root thus:
+....
+dnf config-manager --set-enabled crb
+dnf install \
+    https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm \
+    https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-9.noarch.rpm
+....
 
-* RHEL/CentOS 7:
+=== EL8
 
-`# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm`
+==== CentOS Stream 8
 
-* on RHEL 7 it is recommended to also enable the optional, extras, and
-HA repositories since EPEL packages may depend on packages from these
-repositories:
+....
+dnf config-manager --set-enabled powertools
+dnf install epel-release epel-next-release
+....
 
-`# subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms"  --enable "rhel-ha-for-rhel-*-server-rpms"`
+==== RHEL 8
 
-* RHEL/CentOS 8:
+....
+subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms
+dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
+....
 
-`# yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm`
+==== CentOS Linux 8, AlmaLinux 8, Rocky Linux 8
 
-* CentOS Stream 8:
+....
+dnf config-manager --set-enabled powertools
+dnf install epel-release
+....
 
-`# dnf install epel-release`
+=== EL7
 
-* on RHEL 8 it is required to also enable the
-codeready-builder-for-rhel-8-*-rpms repository since EPEL packages may
-depend on packages from it:
+==== RHEL 7
 
-`# subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"`
+....
+subscription-manager repos --enable rhel-*-optional-rpms \
+                           --enable rhel-*-extras-rpms \
+                           --enable rhel-ha-for-rhel-*-server-rpms
+yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
+....
 
-* on CentOS 8 it is recommended to also enable the powertools repository
-since EPEL packages may depend on packages from it:
+==== CentOS 7
 
-`# dnf config-manager --set-enabled powertools`
+....
+yum install epel-release
+....
 
 [[what_is_extra_packages_for_enterprise_linux_or_epel]]
 == What is Extra Packages for Enterprise Linux (or EPEL)?