diff --git a/docs/src/main/asciidoc/_includes/snip-note-derby.adoc b/docs/src/main/asciidoc/_includes/snip-note-derby.adoc
new file mode 100644
index 0000000000000..e69de29bb2d1d
diff --git a/docs/src/main/asciidoc/datasource.adoc b/docs/src/main/asciidoc/datasource.adoc
index cc16c346dd980..26efbb68acb09 100644
--- a/docs/src/main/asciidoc/datasource.adoc
+++ b/docs/src/main/asciidoc/datasource.adoc
@@ -65,10 +65,8 @@ For more details and optional configurations, see xref:databases-dev-services.ad
 
 * `quarkus-jdbc-db2`
 * `quarkus-jdbc-derby`
-ifdef::note-quarkus-derby[]
 +
-{note-quarkus-derby}
-endif::note-quarkus-derby[]
+include::_includes/snip-note-derby.adoc[]
 * `quarkus-jdbc-h2`
 * `quarkus-jdbc-mariadb`
 * `quarkus-jdbc-mssql`
@@ -155,10 +153,8 @@ Quarkus currently includes the following built-in database kinds:
 +
 * DB2: `db2`
 * Derby: `derby`
-ifdef::note-quarkus-derby[]
 +
-{note-quarkus-derby}
-endif::note-quarkus-derby[]
+include::_includes/snip-note-derby.adoc[]
 * H2: `h2`
 * MariaDB: `mariadb`
 * Microsoft SQL Server: `mssql`
@@ -199,10 +195,8 @@ JDBC is the most common database connection pattern, typically needed when used
 .. For use with a built-in JDBC driver, choose and add the Quarkus extension for your relational database driver from the list below:
 +
 * Derby - `quarkus-jdbc-derby`
-ifdef::note-quarkus-derby[]
 +
-{note-quarkus-derby}
-endif::note-quarkus-derby[]
+include::_includes/snip-note-derby.adoc[]
 * H2 - `quarkus-jdbc-h2`
 +
 [NOTE]