diff --git a/doc/conf_ref.rst b/doc/conf_ref.rst
index f52a4acd80..6dda52b939 100644
--- a/doc/conf_ref.rst
+++ b/doc/conf_ref.rst
@@ -1268,6 +1268,15 @@ Files
     alphanumeric characters and underscores and be in lowercase.
     Variables are also read from /etc/yum/vars for YUM compatibility reasons.
 
+
+Source and debuginfo repository names
+=====================================
+
+For a given repository with an ID in the form "<ID>-rpms", its corresponding source repository is expected to have an ID in the form "<ID>-source-rpms" and debuginfo repository an ID in the form "<ID>-debug-rpms". Otherwise (if the repository doesn't have the suffix "-rpms"), the source repository is expected to have an ID in the form "<ID>-source" and debuginfo repository an ID in the form "<ID>-debuginfo".
+
+For example, for repository "fedora", the source repository is "fedora-source" and debuginfo repository is "fedora-debuginfo". For repository "fedora-rpms", the source repository is "fedora-source-rpms" and debuginfo repository is "fedora-debug-rpms".
+
+
 ==========
  See Also
 ==========