diff --git a/mock-core-configs/README.md b/mock-core-configs/README.md
new file mode 100644
index 000000000..feeaa2db3
--- /dev/null
+++ b/mock-core-configs/README.md
@@ -0,0 +1,32 @@
+# Mock core configs
+
+Some mock configs in this package are maintained by the community.
+When encountering an issue please use your best judgement to decide
+whether a Mock config is broken, or the distribution is broken.
+
+If a Mock config is broken (e.g. [#756][mock-756]), please
+[create a ticket for this repository][mock-issues]
+and tag the responsible maintainer from the table below.
+
+If a distribution is broken (e.g. [#889][mock-889]), please report the
+issue to the appropriate issue tracker for the distribution.
+
+
+| Distribution                                                    | Chroots           | Maintainer                                       | Issue tracker |
+| --------------------------------------------------------------- | ----------------- | ------------------------------------------------ | ------------- |
+| [AlmaLinux](https://almalinux.org/)                             | `almalinux-*`     | [@Conan-Kudo](https://github.com/Conan-Kudo)     | [Issues](https://bugs.almalinux.org/)  |
+| [Amazon Linux 2](https://aws.amazon.com/amazon-linux-2/)        | `amazonlinux-2-*` | [@stewartsmith](https://github.com/stewartsmith) | NA  |
+| [Amazon Linux](https://aws.amazon.com/linux/amazon-linux-2023/) | `amazonlinux-*`   | [@amazonlinux](https://github.com/amazonlinux)   | [Issues](https://github.com/amazonlinux/amazon-linux-2023/issues)  |
+| [Anolis](https://openanolis.cn/)                                | `anolis-*`        | NA                                               | [Issues](https://bugzilla.openanolis.cn/)  |
+| [Circle Linux](https://cclinux.org/)                            | `circlelinux-*`   | [@bella485](https://github.com/bella485)         | [Issues](https://bugzilla.cclinux.org/)  |
+| [EuroLinux](https://en.euro-linux.com/)                         | `eurolinux-*`     | [@nkadel](https://github.com/nkadel)             | [Issues](https://github.com/EuroLinux/eurolinux-distro-bugs-and-rfc)  |
+| [Fedora ELN](https://docs.fedoraproject.org/en-US/eln/)         | `fedora-eln-*`    | [@fedora-eln](https://github.com/fedora-eln)     | [Issues](https://github.com/fedora-eln/eln/issues)  |
+| [Fedora](https://fedoraproject.org/)                            | `fedora-*`        | NA                                               | [Issues](https://bugzilla.redhat.com/)  |
+| [Mageia](https://www.mageia.org/en/)                            | `mageia-*`        | [@Conan-Kudo](https://github.com/Conan-Kudo)     | [Issues](https://bugs.mageia.org/)  |
+| [openEuler](https://www.openeuler.org/en/)                      | `openeuler-*`     | [@Yikun](https://github.com/Yikun)               | NA  |
+| [Rocky Linux](https://rockylinux.org/)                          | `rocky-*`         | [@nazunalika](https://github.com/nazunalika)     | [Issues](https://bugs.rockylinux.org/)  |
+
+
+[mock-issues]: https://github.com/rpm-software-management/mock/issues
+[mock-756]: https://github.com/rpm-software-management/mock/issues/756
+[mock-889]: https://github.com/rpm-software-management/mock/issues/889
diff --git a/mock-core-configs/mock-core-configs.spec b/mock-core-configs/mock-core-configs.spec
index a1c2c4ac3..afd1e9a82 100644
--- a/mock-core-configs/mock-core-configs.spec
+++ b/mock-core-configs/mock-core-configs.spec
@@ -147,6 +147,7 @@ fi
 
 %files -f %{name}.cfgs
 %license COPYING
+%doc README.md
 %ghost %config(noreplace,missingok) %{_sysconfdir}/mock/default.cfg
 
 %changelog