diff --git a/docs/api.md b/docs/api.md
index 3e898546b2..1a1679b41d 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -1,3 +1,3 @@
 # API Reference
 
-Moved to [here](/docs/api).
\ No newline at end of file
+This [page has moved](api).
diff --git a/docs/api/README.md b/docs/api/README.md
index a285ca903a..acc979ab1e 100644
--- a/docs/api/README.md
+++ b/docs/api/README.md
@@ -1,6 +1,6 @@
-# CRDs
+# API reference for CRDs
 
 - [Instrumentation](instrumentations.md)
 - [OpAMPBridge](opampbridges.md)
 - [OpenTelemetryCollector](opentelemetrycollectors.md)
-- [TargetAllocator](targetallocators.md)
\ No newline at end of file
+- [TargetAllocator](targetallocators.md)