From 4705e82a6ed2937568fa9c999e4988b45f598451 Mon Sep 17 00:00:00 2001
From: Andy Wilkinson <wilkinsona@vmware.com>
Date: Tue, 28 Mar 2023 09:33:06 +0100
Subject: [PATCH] Note that optional dependencies are included by run and
 repackage

Closes gh-34636
---
 .../spring-boot-maven-plugin/src/docs/asciidoc/packaging.adoc   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging.adoc b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging.adoc
index 081df491315..e1267270956 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging.adoc
+++ b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging.adoc
@@ -218,6 +218,8 @@ Layout factories are always ignored if an explicit <<goals-repackage-parameters-
 === Dependency Exclusion
 By default, both the `repackage` and the `run` goals will include any `provided` dependencies that are defined in the project.
 A Spring Boot project should consider `provided` dependencies as "container" dependencies that are required to run the application.
+Generally speaking, Spring Boot projects are not used as dependencies and are therefore unlikely to have any `optional` dependencies.
+When a project does have optional dependencies they too will be included by the `repackage` and `run` goals.
 
 Some of these dependencies may not be required at all and should be excluded from the executable jar.
 For consistency, they should not be present either when running the application.