diff --git a/docs/features/software-catalog/index.md b/docs/features/software-catalog/index.md
index 28712ff0b9..c98d6911b4 100644
--- a/docs/features/software-catalog/index.md
+++ b/docs/features/software-catalog/index.md
@@ -40,9 +40,11 @@ browse the catalog at `http://localhost:3000`.
 
 ## Adding components to the catalog
 
-The source of truth for the components in your software catalog are
-[metadata YAML files](descriptor-format.md) stored in source control (GitHub,
-GitHub Enterprise, GitLab, ...).
+The source of truth for the components in your software catalog are [metadata
+YAML files](descriptor-format.md) stored in source control (GitHub, GitHub
+Enterprise, GitLab, ...). Repositories can include one or multiple metadata
+files. Usually the metadata file is located in the repository root. This is not
+a formal requirement & metadata files can be placed anywhere in the repository.
 
 There are 3 ways to add components to the catalog: