diff --git a/README.md b/README.md
index b2056d04..f3a5086f 100644
--- a/README.md
+++ b/README.md
@@ -2,4 +2,6 @@
 
 [![Build Status](https://apm-ci.elastic.co/buildStatus/icon?job=library%2Fapm-aws-lambda-mbp%2Fmain)](https://apm-ci.elastic.co/job/library/job/apm-aws-lambda-mbp/job/main/)
 
-A repository for the experimental AWS Lambda extension and other lambda related tools and build scripts.
+This repository contains code and tools for working with Elastic APM's AWS Lambda solution.  
+
+If you're looking to get started with Elastic's AWS Lambda extension and agent instrumentation, the [AWS Lambda Extension](https://github.com/elastic/apm-aws-lambda/blob/main/docs/aws-lambda-extension.asciidoc) documentation is the place to start. 
\ No newline at end of file
diff --git a/docs/.DS_Store b/docs/.DS_Store
new file mode 100644
index 00000000..9512a176
Binary files /dev/null and b/docs/.DS_Store differ
diff --git a/apm-lambda-extension/docs/aws-lambda-extension.asciidoc b/docs/aws-lambda-extension.asciidoc
similarity index 100%
rename from apm-lambda-extension/docs/aws-lambda-extension.asciidoc
rename to docs/aws-lambda-extension.asciidoc
diff --git a/apm-lambda-extension/docs/images/assets.png b/docs/images/assets.png
similarity index 100%
rename from apm-lambda-extension/docs/images/assets.png
rename to docs/images/assets.png
diff --git a/apm-lambda-extension/docs/images/config-layer.png b/docs/images/config-layer.png
similarity index 100%
rename from apm-lambda-extension/docs/images/config-layer.png
rename to docs/images/config-layer.png
diff --git a/apm-lambda-extension/docs/images/data-flow.png b/docs/images/data-flow.png
similarity index 100%
rename from apm-lambda-extension/docs/images/data-flow.png
rename to docs/images/data-flow.png
diff --git a/apm-lambda-extension/docs/images/layers.png b/docs/images/layers.png
similarity index 100%
rename from apm-lambda-extension/docs/images/layers.png
rename to docs/images/layers.png