aws · yaythomas · Jul 14, 2026 · Jul 14, 2026
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -34,6 +34,9 @@ jobs:
 
       - name: Verify vendored GLightbox
         run: python3 scripts/vendor_glightbox.py --check
+
+      - name: Verify example references
+        run: python3 scripts/check_example_refs.py
 
       - name: Build documentation
         run: zensical build --clean

diff --git a/examples/java/advanced/serialization/appropriate-types.java b/examples/java/advanced/serialization/appropriate-types.java
diff --git a/examples/java/advanced/serialization/callback-config.java b/examples/java/advanced/serialization/callback-config.java
diff --git a/examples/java/advanced/serialization/container-types.java b/examples/java/advanced/serialization/container-types.java
diff --git a/examples/java/advanced/serialization/convert-to-dicts.java b/examples/java/advanced/serialization/convert-to-dicts.java
diff --git a/examples/java/advanced/serialization/custom-objects.java b/examples/java/advanced/serialization/custom-objects.java
diff --git a/examples/java/advanced/serialization/custom-serdes.java b/examples/java/advanced/serialization/custom-serdes.java
diff --git a/examples/java/advanced/serialization/dataclasses.java b/examples/java/advanced/serialization/dataclasses.java
diff --git a/examples/java/advanced/serialization/datetime-timezone.java b/examples/java/advanced/serialization/datetime-timezone.java
diff --git a/examples/java/advanced/serialization/default-behavior.java b/examples/java/advanced/serialization/default-behavior.java
diff --git a/examples/java/advanced/serialization/encryption.java b/examples/java/advanced/serialization/encryption.java
diff --git a/examples/java/advanced/serialization/extended-types.java b/examples/java/advanced/serialization/extended-types.java
diff --git a/examples/java/advanced/serialization/faq-binary-data.java b/examples/java/advanced/serialization/faq-binary-data.java
diff --git a/examples/java/advanced/serialization/faq-debug-issues.java b/examples/java/advanced/serialization/faq-debug-issues.java
diff --git a/examples/java/advanced/serialization/faq-json-strings.java b/examples/java/advanced/serialization/faq-json-strings.java
diff --git a/examples/java/advanced/serialization/faq-pydantic-models.java b/examples/java/advanced/serialization/faq-pydantic-models.java
diff --git a/examples/java/advanced/serialization/faq-serialization-fails.java b/examples/java/advanced/serialization/faq-serialization-fails.java
diff --git a/examples/java/advanced/serialization/handle-errors-gracefully.java b/examples/java/advanced/serialization/handle-errors-gracefully.java
diff --git a/examples/java/advanced/serialization/keep-data-small.java b/examples/java/advanced/serialization/keep-data-small.java
diff --git a/examples/java/advanced/serialization/large-payload-errors.java b/examples/java/advanced/serialization/large-payload-errors.java
diff --git a/examples/java/advanced/serialization/map-parallel-config.java b/examples/java/advanced/serialization/map-parallel-config.java
diff --git a/examples/java/advanced/serialization/primitive-types.java b/examples/java/advanced/serialization/primitive-types.java
diff --git a/examples/java/advanced/serialization/pydantic-models.java b/examples/java/advanced/serialization/pydantic-models.java
diff --git a/examples/java/advanced/serialization/serialization-failed-error.java b/examples/java/advanced/serialization/serialization-failed-error.java
diff --git a/examples/java/advanced/serialization/step-config.java b/examples/java/advanced/serialization/step-config.java
diff --git a/examples/java/advanced/serialization/test-round-trips.java b/examples/java/advanced/serialization/test-round-trips.java
diff --git a/examples/java/advanced/serialization/type-not-preserved.java b/examples/java/advanced/serialization/type-not-preserved.java
diff --git a/examples/java/advanced/serialization/unsupported-type-error.java b/examples/java/advanced/serialization/unsupported-type-error.java
diff --git a/examples/java/advanced/serialization/use-custom-serdes.java b/examples/java/advanced/serialization/use-custom-serdes.java
diff --git a/examples/java/advanced/serialization/use-default-serialization.java b/examples/java/advanced/serialization/use-default-serialization.java
diff --git a/examples/java/advanced/testing-modes/appropriate-timeouts.java b/examples/java/advanced/testing-modes/appropriate-timeouts.java
diff --git a/examples/java/advanced/testing-modes/basic-cloud-test.java b/examples/java/advanced/testing-modes/basic-cloud-test.java
diff --git a/examples/java/advanced/testing-modes/custom-timeout.java b/examples/java/advanced/testing-modes/custom-timeout.java
diff --git a/examples/java/advanced/testing-modes/durable-execution-decorator.java b/examples/java/advanced/testing-modes/durable-execution-decorator.java
diff --git a/examples/java/advanced/testing-modes/mode-agnostic-tests.java b/examples/java/advanced/testing-modes/mode-agnostic-tests.java
diff --git a/examples/java/advanced/testing-modes/mode-specific-assertions.java b/examples/java/advanced/testing-modes/mode-specific-assertions.java
diff --git a/examples/java/advanced/testing-modes/test-markers.java b/examples/java/advanced/testing-modes/test-markers.java
diff --git a/examples/java/advanced/testing-modes/timeout-error.java b/examples/java/advanced/testing-modes/timeout-error.java
diff --git a/examples/java/core/callbacks/basic-callback-testing.java b/examples/java/core/callbacks/basic-callback-testing.java
diff --git a/examples/java/core/callbacks/basic-example.java b/examples/java/core/callbacks/basic-example.java
diff --git a/examples/java/core/callbacks/callback-config.java b/examples/java/core/callbacks/callback-config.java
diff --git a/examples/java/core/callbacks/callback-with-fallback.java b/examples/java/core/callbacks/callback-with-fallback.java
diff --git a/examples/java/core/callbacks/conditional-callback-handling.java b/examples/java/core/callbacks/conditional-callback-handling.java
diff --git a/examples/java/core/callbacks/create-callback-signature.java b/examples/java/core/callbacks/create-callback-signature.java
diff --git a/examples/java/core/callbacks/duration-helpers.java b/examples/java/core/callbacks/duration-helpers.java
diff --git a/examples/java/core/callbacks/get-callback-id.java b/examples/java/core/callbacks/get-callback-id.java
diff --git a/examples/java/core/callbacks/get-callback-result.java b/examples/java/core/callbacks/get-callback-result.java
diff --git a/examples/java/core/callbacks/human-approval-workflow.java b/examples/java/core/callbacks/human-approval-workflow.java
diff --git a/examples/java/core/callbacks/inspect-callback-operations.java b/examples/java/core/callbacks/inspect-callback-operations.java
diff --git a/examples/java/core/callbacks/message-broker-durable-function.java b/examples/java/core/callbacks/message-broker-durable-function.java
diff --git a/examples/java/core/callbacks/message-broker-notification-handler.java b/examples/java/core/callbacks/message-broker-notification-handler.java
diff --git a/examples/java/core/callbacks/multiple-callbacks.java b/examples/java/core/callbacks/multiple-callbacks.java
diff --git a/examples/java/core/callbacks/notify-failure.java b/examples/java/core/callbacks/notify-failure.java
diff --git a/examples/java/core/callbacks/notify-success.java b/examples/java/core/callbacks/notify-success.java
diff --git a/examples/java/core/callbacks/payment-processing.java b/examples/java/core/callbacks/payment-processing.java
diff --git a/examples/java/core/callbacks/send-heartbeat.java b/examples/java/core/callbacks/send-heartbeat.java
diff --git a/examples/java/core/callbacks/test-callback-timeout.java b/examples/java/core/callbacks/test-callback-timeout.java
diff --git a/examples/java/core/callbacks/test-integration-workflow.java b/examples/java/core/callbacks/test-integration-workflow.java
diff --git a/examples/java/core/callbacks/third-party-api-integration.java b/examples/java/core/callbacks/third-party-api-integration.java
diff --git a/examples/java/core/callbacks/wait-for-external-system.java b/examples/java/core/callbacks/wait-for-external-system.java
diff --git a/examples/java/core/callbacks/wait-using-result.java b/examples/java/core/callbacks/wait-using-result.java
diff --git a/examples/java/core/callbacks/wait-using-wait-for-callback.java b/examples/java/core/callbacks/wait-using-wait-for-callback.java
diff --git a/examples/java/core/invoke/handle-invocation-error.java b/examples/java/core/invoke/handle-invocation-error.java
diff --git a/examples/java/core/invoke/handle-timeout-error.java b/examples/java/core/invoke/handle-timeout-error.java
diff --git a/examples/java/core/invoke/invoke-method-signature.java b/examples/java/core/invoke/invoke-method-signature.java
diff --git a/examples/java/core/invoke/invoke-ondemand-function.java b/examples/java/core/invoke/invoke-ondemand-function.java
diff --git a/examples/java/core/invoke/invoke-service.java b/examples/java/core/invoke/invoke-service.java
diff --git a/examples/java/core/invoke/invoke-with-config.java b/examples/java/core/invoke/invoke-with-config.java
diff --git a/examples/java/core/invoke/orchestrate-workflow.java b/examples/java/core/invoke/orchestrate-workflow.java
diff --git a/examples/java/core/invoke/parent-workflow.java b/examples/java/core/invoke/parent-workflow.java
diff --git a/examples/java/core/invoke/pass-context-between-invocations.java b/examples/java/core/invoke/pass-context-between-invocations.java
diff --git a/examples/java/core/invoke/pass-result-between-invokes.java b/examples/java/core/invoke/pass-result-between-invokes.java
diff --git a/examples/java/core/invoke/process-document.java b/examples/java/core/invoke/process-document.java
diff --git a/examples/java/core/invoke/process-order.java b/examples/java/core/invoke/process-order.java
diff --git a/examples/java/core/invoke/retry-example-10.java b/examples/java/core/invoke/retry-example-10.java
diff --git a/examples/java/core/invoke/serialize.java b/examples/java/core/invoke/serialize.java
diff --git a/examples/java/core/invoke/set-timeout.java b/examples/java/core/invoke/set-timeout.java
diff --git a/examples/java/core/invoke/test-basic-invoke.java b/examples/java/core/invoke/test-basic-invoke.java
diff --git a/examples/java/core/invoke/test-error-handling.java b/examples/java/core/invoke/test-error-handling.java
diff --git a/examples/java/core/invoke/test-inspect-invoke.java b/examples/java/core/invoke/test-inspect-invoke.java
diff --git a/examples/java/core/invoke/test-mock-invoked-functions.java b/examples/java/core/invoke/test-mock-invoked-functions.java
diff --git a/examples/java/core/invoke/test-timeout-handling.java b/examples/java/core/invoke/test-timeout-handling.java
diff --git a/examples/java/core/logger/add-custom-metadata.java b/examples/java/core/logger/add-custom-metadata.java
diff --git a/examples/java/core/logger/automatic-context-enrichment.java b/examples/java/core/logger/automatic-context-enrichment.java
diff --git a/examples/java/core/logger/avoid-sensitive-data.java b/examples/java/core/logger/avoid-sensitive-data.java
diff --git a/examples/java/core/logger/basic-usage.java b/examples/java/core/logger/basic-usage.java
diff --git a/examples/java/core/logger/child-workflow.java b/examples/java/core/logger/child-workflow.java
diff --git a/examples/java/core/logger/context-logger-deduplication.java b/examples/java/core/logger/context-logger-deduplication.java
diff --git a/examples/java/core/logger/direct-logger-duplicates.java b/examples/java/core/logger/direct-logger-duplicates.java
diff --git a/examples/java/core/logger/include-business-context.java b/examples/java/core/logger/include-business-context.java
diff --git a/examples/java/core/logger/integrate-powertools-context.java b/examples/java/core/logger/integrate-powertools-context.java
diff --git a/examples/java/core/logger/lambda-log-controls.java b/examples/java/core/logger/lambda-log-controls.java
diff --git a/examples/java/core/logger/logger-interface-protocol.java b/examples/java/core/logger/logger-interface-protocol.java
diff --git a/examples/java/core/logger/logger-method-signature.java b/examples/java/core/logger/logger-method-signature.java
diff --git a/examples/java/core/logger/powertools-with-deduplication.java b/examples/java/core/logger/powertools-with-deduplication.java
diff --git a/examples/java/core/logger/selective-logging.java b/examples/java/core/logger/selective-logging.java
diff --git a/examples/java/core/logger/set-powertools-log-level.java b/examples/java/core/logger/set-powertools-log-level.java
diff --git a/examples/java/core/logger/set-standard-log-level.java b/examples/java/core/logger/set-standard-log-level.java
diff --git a/examples/java/core/logger/silence-botocore.java b/examples/java/core/logger/silence-botocore.java
diff --git a/examples/java/core/logger/structured-logging-extra.java b/examples/java/core/logger/structured-logging-extra.java
diff --git a/examples/java/core/logger/test-basic-logger.java b/examples/java/core/logger/test-basic-logger.java
diff --git a/examples/java/core/logger/test-verify-log-output.java b/examples/java/core/logger/test-verify-log-output.java
diff --git a/examples/java/core/logger/test-with-powertools.java b/examples/java/core/logger/test-with-powertools.java
diff --git a/examples/java/core/logger/use-powertools-directly.java b/examples/java/core/logger/use-powertools-directly.java
diff --git a/examples/java/core/logger/use-powertools-production.java b/examples/java/core/logger/use-powertools-production.java
diff --git a/examples/java/core/map/access-individual-results.java b/examples/java/core/map/access-individual-results.java
diff --git a/examples/java/core/map/check-inventory.java b/examples/java/core/map/check-inventory.java
diff --git a/examples/java/core/map/custom-completion-criteria.java b/examples/java/core/map/custom-completion-criteria.java
diff --git a/examples/java/core/map/fetch-data.java b/examples/java/core/map/fetch-data.java
diff --git a/examples/java/core/map/fetch-user-data.java b/examples/java/core/map/fetch-user-data.java
diff --git a/examples/java/core/map/map-function-signature.java b/examples/java/core/map/map-function-signature.java
diff --git a/examples/java/core/map/map-method-signature.java b/examples/java/core/map/map-method-signature.java
diff --git a/examples/java/core/map/process-item.java b/examples/java/core/map/process-item.java
diff --git a/examples/java/core/map/square.java b/examples/java/core/map/square.java
diff --git a/examples/java/core/map/test-basic-map.java b/examples/java/core/map/test-basic-map.java
diff --git a/examples/java/core/map/test-error-handling.java b/examples/java/core/map/test-error-handling.java
diff --git a/examples/java/core/map/test-handle-partial-failures.java b/examples/java/core/map/test-handle-partial-failures.java
diff --git a/examples/java/core/map/test-inspect-items.java b/examples/java/core/map/test-inspect-items.java
diff --git a/examples/java/core/map/test-with-config.java b/examples/java/core/map/test-with-config.java
diff --git a/examples/java/core/map/validate-email.java b/examples/java/core/map/validate-email.java
diff --git a/examples/java/core/parallel/access-individual-results.java b/examples/java/core/parallel/access-individual-results.java
diff --git a/examples/java/core/parallel/all-completed-strategy.java b/examples/java/core/parallel/all-completed-strategy.java
diff --git a/examples/java/core/parallel/all-successful-strategy.java b/examples/java/core/parallel/all-successful-strategy.java
diff --git a/examples/java/core/parallel/basic-usage.java b/examples/java/core/parallel/basic-usage.java
diff --git a/examples/java/core/parallel/check-failures.java b/examples/java/core/parallel/check-failures.java
diff --git a/examples/java/core/parallel/collect-results.java b/examples/java/core/parallel/collect-results.java
diff --git a/examples/java/core/parallel/completion-config.java b/examples/java/core/parallel/completion-config.java
diff --git a/examples/java/core/parallel/concurrency-limits.java b/examples/java/core/parallel/concurrency-limits.java
diff --git a/examples/java/core/parallel/controlled-concurrency.java b/examples/java/core/parallel/controlled-concurrency.java
diff --git a/examples/java/core/parallel/first-successful-pattern.java b/examples/java/core/parallel/first-successful-pattern.java
diff --git a/examples/java/core/parallel/first-successful-strategy.java b/examples/java/core/parallel/first-successful-strategy.java
diff --git a/examples/java/core/parallel/handle-partial-results.java b/examples/java/core/parallel/handle-partial-results.java
diff --git a/examples/java/core/parallel/individual-branch-failures.java b/examples/java/core/parallel/individual-branch-failures.java
diff --git a/examples/java/core/parallel/max-concurrency.java b/examples/java/core/parallel/max-concurrency.java
diff --git a/examples/java/core/parallel/nested-parallel.java b/examples/java/core/parallel/nested-parallel.java
diff --git a/examples/java/core/parallel/parallel-config.java b/examples/java/core/parallel/parallel-config.java
diff --git a/examples/java/core/parallel/parallel-method-signature.java b/examples/java/core/parallel/parallel-method-signature.java
diff --git a/examples/java/core/parallel/partial-success-handling.java b/examples/java/core/parallel/partial-success-handling.java
diff --git a/examples/java/core/parallel/pass-different-arguments.java b/examples/java/core/parallel/pass-different-arguments.java
diff --git a/examples/java/core/parallel/result-ordering.java b/examples/java/core/parallel/result-ordering.java
diff --git a/examples/java/core/parallel/simple-parallel.java b/examples/java/core/parallel/simple-parallel.java
diff --git a/examples/java/core/parallel/test-basic-parallel.java b/examples/java/core/parallel/test-basic-parallel.java
diff --git a/examples/java/core/parallel/test-completion-strategies.java b/examples/java/core/parallel/test-completion-strategies.java
diff --git a/examples/java/core/parallel/test-concurrency-limits.java b/examples/java/core/parallel/test-concurrency-limits.java
diff --git a/examples/java/core/parallel/test-error-handling.java b/examples/java/core/parallel/test-error-handling.java
diff --git a/examples/java/core/parallel/test-inspect-branches.java b/examples/java/core/parallel/test-inspect-branches.java
diff --git a/examples/java/core/steps/basic-step-testing.java b/examples/java/core/steps/basic-step-testing.java
diff --git a/examples/java/core/steps/inspect-step-results.java b/examples/java/core/steps/inspect-step-results.java
diff --git a/examples/java/core/steps/lambda-step-example.java b/examples/java/core/steps/lambda-step-example.java
diff --git a/examples/java/core/steps/test-error-handling.java b/examples/java/core/steps/test-error-handling.java
diff --git a/examples/java/core/steps/test-retry-behavior.java b/examples/java/core/steps/test-retry-behavior.java
diff --git a/examples/java/core/wait/appropriate-durations.java b/examples/java/core/wait/appropriate-durations.java
diff --git a/examples/java/core/wait/duration-from-seconds.java b/examples/java/core/wait/duration-from-seconds.java
diff --git a/examples/java/core/wait/minimum-wait-duration.java b/examples/java/core/wait/minimum-wait-duration.java
diff --git a/examples/java/core/wait/multiple-named-waits.java b/examples/java/core/wait/multiple-named-waits.java