As discussed in #20920, I have enhanced the Database initialization guide clarifying the expected behavior when using a higher-level Database Migration Tool.

I also wanted to add a description for the spring.datasource.initialization-mode property, but I wasn't able to find the config-docs/data.adoc file. Proposed description for that property:

Type of datasource you want to initialize. Use always to initialize the DataSource regardless of its type.

Comment From: snicoll

That's excellent @nikmanzotti, thank you very much.

Comment From: snicoll

I also wanted to add a description for the spring.datasource.initialization-mode property

It is generated from the code, the current description is "Initialize the datasource with available DDL and DML scripts." I agree that this can be improved and we can do that as part of a separate issue. Type of datasource can be misleading IMO.

Comment From: snicoll

@nikmanzotti thank you for making your first contribution to Spring Boot.