diff --git a/docs/master/introduction/composition.md b/docs/master/introduction/composition.md
index 66a3c5da..3a7cc433 100644
--- a/docs/master/introduction/composition.md
+++ b/docs/master/introduction/composition.md
@@ -79,7 +79,7 @@ corresponding `MySQLInstance` claim.
 ## Defining Infrastructure
 
 New kinds of infrastructure resource are defined by an infrastructure operator.
-There are three steps to this process:
+There are two steps to this process:
 
 1. Define your composite resource, and optionally the claim it offers.
 1. Specify one or more possible ways your composite resource may be composed.
diff --git a/docs/master/introduction/managed-resources.md b/docs/master/introduction/managed-resources.md
index 0f0f4f72..adb3c725 100644
--- a/docs/master/introduction/managed-resources.md
+++ b/docs/master/introduction/managed-resources.md
@@ -266,5 +266,5 @@ including Velero.
 
 [api-versioning]: https://kubernetes.io/docs/reference/using-api/api-overview/#api-versioning
 [velero]: https://velero.io/
-[api-reference]: api-docs/overview.md
-[provider]: provider.md
+[api-reference]: ../api-docs/overview.md
+[provider]: providers.md