diff --git a/README.md b/README.md index 9a64fa312efe..ef7213155e86 100644 --- a/README.md +++ b/README.md @@ -105,6 +105,11 @@ having to create a separate distribution or to fork this repository. For example custom samplers or span exporters, set new defaults, and embed it all in the agent to obtain a single jar file. +## Creating an agent distribution + +[Distribution](examples/distro/README.md) provides guidance on creating a separate distribution, serving as a collection of examples for extending the functionality of the OpenTelemetry Java instrumentation agent. It also demonstrates how to repackage the agent while incorporating custom features. +[Agent extensions](#creating-agent-extensions) are recommended instead for most users as they are simpler and do not require rebuilding with each OpenTelemetry Java agent release. + ## Manually instrumenting For most users, the out-of-the-box instrumentation is completely sufficient and nothing more has to