diff --git a/docs/guides/add-ebean-postgres-database-config.md b/docs/guides/add-ebean-postgres-database-config.md
index 1fddb0a136..c16ac55e65 100644
--- a/docs/guides/add-ebean-postgres-database-config.md
+++ b/docs/guides/add-ebean-postgres-database-config.md
@@ -148,7 +148,6 @@ Database database(Configuration config) {
     return Database.builder()
         .name("db")
         .dataSourceBuilder(dataSource)
-        .skipDataSourceCheck(true)
         .build();
 }
 ```
@@ -156,6 +155,11 @@ Database database(Configuration config) {
 If the project has a dedicated config-wrapper class (a `@Component` that reads config
 keys), accept it as a parameter instead of `Configuration`.
 
+> **Note:** Injecting `Configuration` requires that `avaje-config` is properly wired
+> into the DI context. If you encounter "No dependency provided for
+> io.avaje.config.Configuration" errors, use `Config.get(...)` static access instead
+> (as shown in Step 2).
+
 ---
 
 ## Step 4 (Optional) — Add a read-only datasource
diff --git a/docs/guides/add-ebean-postgres-maven-pom.md b/docs/guides/add-ebean-postgres-maven-pom.md
index 71794e86f5..948278cf2e 100644
--- a/docs/guides/add-ebean-postgres-maven-pom.md
+++ b/docs/guides/add-ebean-postgres-maven-pom.md
@@ -85,7 +85,7 @@ already exist:
 ```xml
 <properties>
     <!-- add this line; use latest stable from https://github.com/ebean-orm/ebean/releases -->
-    <ebean.version>17.2.0</ebean.version>
+    <ebean.version>17.5.0</ebean.version>
 </properties>
 ```
 
@@ -141,8 +141,17 @@ for Postgres test instances:
     <version>${ebean.version}</version>
     <scope>test</scope>
 </dependency>
+<dependency>
+    <groupId>io.avaje</groupId>
+    <artifactId>junit</artifactId>
+    <version>1.8</version>
+    <scope>test</scope>
+</dependency>
 ```
 
+The `io.avaje:junit` bundle includes JUnit Jupiter (API + engine) and AssertJ,
+avoiding the need to declare those dependencies separately.
+
 ---
 
 ## Step 4b — Add DI framework dependencies (if applicable)
@@ -156,12 +165,12 @@ annotation processor. Skip this step if the user chose Spring or no DI.
 <dependency>
     <groupId>io.avaje</groupId>
     <artifactId>avaje-inject</artifactId>
-    <version>11.5</version>
+    <version>12.5</version>
 </dependency>
 <dependency>
     <groupId>io.avaje</groupId>
     <artifactId>avaje-inject-test</artifactId>
-    <version>11.5</version>
+    <version>12.5</version>
     <scope>test</scope>
 </dependency>
 ```
@@ -185,7 +194,7 @@ the final `<annotationProcessorPaths>` block should include both:
     <path> <!-- generate avaje-inject DI code -->
         <groupId>io.avaje</groupId>
         <artifactId>avaje-inject-generator</artifactId>
-        <version>11.5</version>
+        <version>12.5</version>
     </path>
 </annotationProcessorPaths>
 ```
diff --git a/docs/guides/add-ebean-postgres-test-container.md b/docs/guides/add-ebean-postgres-test-container.md
index 54d909c342..8a4f1bffe4 100644
--- a/docs/guides/add-ebean-postgres-test-container.md
+++ b/docs/guides/add-ebean-postgres-test-container.md
@@ -433,3 +433,13 @@ mkdir -p ~/.ebean && touch ~/.ebean/ignore-docker-shutdown
 ```
 
 On CI servers, omit this file so containers are cleaned up after each build.
+
+---
+
+## Next Steps
+
+- **Add `TestEntityBuilder`** to your test configuration for rapid test data creation
+  with auto-populated random values. See `testing-with-testentitybuilder.md`.
+- **Proceed to Step 3** — production database configuration
+  (`add-ebean-postgres-database-config.md`). Verify this step passes with
+  `mvn verify` before continuing.
diff --git a/ebean-opentelemetry/src/main/java/io/ebean/opentelemetry/OtelProfileHandler.java b/ebean-opentelemetry/src/main/java/io/ebean/opentelemetry/OtelProfileHandler.java
index 020db0d9f4..f9d1618689 100644
--- a/ebean-opentelemetry/src/main/java/io/ebean/opentelemetry/OtelProfileHandler.java
+++ b/ebean-opentelemetry/src/main/java/io/ebean/opentelemetry/OtelProfileHandler.java
@@ -63,7 +63,7 @@ public void shutdown() {
    */
   @Override
   public @Nullable ProfileStream createProfileStream(@Nullable ProfileLocation location, @Nullable String label) {
-    if (!Span.current().getSpanContext().isValid()) {
+    if (!Span.current().isRecording()) {
       // No active OTel trace context — don't create spans to avoid noise
       return null;
     }