diff --git a/docs/features/software-catalog/index.md b/docs/features/software-catalog/index.md
index 282879d33b..c98d6911b4 100644
--- a/docs/features/software-catalog/index.md
+++ b/docs/features/software-catalog/index.md
@@ -42,8 +42,9 @@ browse the catalog at `http://localhost:3000`.
 
 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 multiple metadata files, and
-there's no requirement for metadata files to be placed in the repository root.
+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: