diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/appendix-executable-jar-format.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/appendix-executable-jar-format.adoc index f8c8321fd2..d4a6fe78ae 100644 --- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/appendix-executable-jar-format.adoc +++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/appendix-executable-jar-format.adoc @@ -90,8 +90,8 @@ Any dependencies that are required when running embedded but are not required wh [[executable-jar-war-index-files]] === Index Files Spring Boot Loader-compatible jar and war archives can include additional index files under the `BOOT-INF/` directory. -A `classpath.idx` file can be provided for both jars and wars, it provides the ordering that jars should be added to the classpath. -The `layers.idx` file can be used only for jars, it allows a jar to be split into logical layers for Docker/OCI image creation. +A `classpath.idx` file can be provided for both jars and wars, and it provides the ordering that jars should be added to the classpath. +The `layers.idx` file can be used only for jars, and it allows a jar to be split into logical layers for Docker/OCI image creation. Index files follow a YAML compatible syntax so that they can be easily parsed by third-party tools. These files, however, are _not_ parsed internally as YAML and they must be written in exactly the formats described below in order to be used.