diff --git a/README.md b/README.md
index f14f462..b628c51 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,28 @@
 # go-rpm-macros-epel
+The go-rpm-macros-epel contains backported Go RPM macros and generators from Fedora. The goal is for EPEL Go packaging to work as similarly as possible to Fedora Go packaging. At the same time, it avoids overriding macros from RHEL more than it has to.
 
-The go-rpm-macros-epel package
+This package contains the following backports:
+
+## go-rpm-macros-epel
+go-rpm-macros-epel contains backports of certain Go RPM macros from Fedora.
+
+- Redefine %goinstallflags to work around [rhbz#2098400](https://bugzilla.redhat.com/show_bug.cgi?id=2098400).
+- Add Fedora's [RPM generator for bundled Provides](https://pagure.io/go-rpm-macros/c/226596177c63c3dc180b5aeda45fe3b18706e877?branch=master).
+
+## go-srpm-macros-epel
+
+go-srpm-macros-epel contains backports of certain Go SRPM macros from Fedora.
+
+- Add support for `%golang_arches_future` and `%gometa -f`. This fixes the issue brought up in [rhbz#2121796](https://bugzilla.redhat.com/2121796)
+- Change `%gometa` to pull in go-rpm-macros-epel. This way, packages don't need to BuildRequire it manually.
+
+## go-rpm-macros-golist-symlink
+go-rpm-macros-golist-symlink provides a symlink from /usr/bin to
+go-rpm-macros's bundled golist, which is installed in
+/usr/libexec/go-rpm-macros. This allows the macros that expect to find golist
+in $PATH to work properly.
+
+This package is split out and namespaced to allow the upstream golist to be
+packaged as golist.
+
+This works around [rhbz#2100618](https://bugzilla.redhat.com/show_bug.cgi?id=2100618).
diff --git a/go-rpm-macros-epel.spec b/go-rpm-macros-epel.spec
index 6d10628..c9bf0bf 100644
--- a/go-rpm-macros-epel.spec
+++ b/go-rpm-macros-epel.spec
@@ -103,4 +103,10 @@ install -Dpm 0644 README.upstream.md %{buildroot}%{_pkgdocdir}/README.md
 
 %changelog
 * Wed Aug 31 2022 Maxwell G <gotmax@e.email> - 1-1
-- Initial package
+- Redfine %%goinstallflags
+  Relates: rhbz#2098400
+- Add support for `%%golang_arches_future` and `%%gometa -f`.
+  Relates: rhbz#2121796
+- Add go-rpm-macros-golist-symlink
+  Relates: rhbz#2100618
+