diff --git a/docs/features/software-catalog/descriptor-format.md b/docs/features/software-catalog/descriptor-format.md
index 59f09b6e58..136f9d5cc2 100644
--- a/docs/features/software-catalog/descriptor-format.md
+++ b/docs/features/software-catalog/descriptor-format.md
@@ -530,7 +530,7 @@ The following describes the following entity kind:
 | `kind`       | `Template`             |
 
 If you're looking for docs on `v1alpha1` you can find them
-[here](../software-templates/legacy)
+[here](../software-templates/legacy.md)
 
 A template definition describes both the parameters that are rendered in the
 frontend part of the scaffolding wizard, and the steps that are executed when
diff --git a/docs/features/software-templates/adding-templates.md b/docs/features/software-templates/adding-templates.md
index 37659f214e..ecb7d11be9 100644
--- a/docs/features/software-templates/adding-templates.md
+++ b/docs/features/software-templates/adding-templates.md
@@ -103,4 +103,4 @@ Or you can add the template using the `catalog-import` plugin, which unless
 configured differently should be running on `/catalog-import`.
 
 For information about writing your own templates, you can check out the docs
-[here](./writing-templates)
+[here](./writing-templates.md)