From dc7d9d72864d79c0175f3c96a0a5588bf23f09c1 Mon Sep 17 00:00:00 2001
From: Hasko <javics86@gmail.com>
Date: Fri, 26 Jun 2026 00:19:28 +0200
Subject: [PATCH] =?UTF-8?q?fix(docs):=20=F0=9F=90=9B=20Clarify=20container?=
 =?UTF-8?q?=20build=20usage?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/.vitepress/config.mts             | 4 ++++
 docs/reference/dependency-injection.md | 2 +-
 docs/reference/kernel.md               | 6 +++++-
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 0b9dd25..072b3a2 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -136,6 +136,10 @@ export default defineConfig({
       { text: 'Getting Started', link: '/getting-started/introduction' },
       { text: 'Guide', link: '/guides/dependency-injection' },
       { text: 'Reference', link: '/reference/' },
+      {
+        text: 'npm',
+        link: 'https://www.npmjs.com/package/@haskou/ddd-kernel',
+      },
     ],
 
     sidebar: {
diff --git a/docs/reference/dependency-injection.md b/docs/reference/dependency-injection.md
index 224e09c..dfc8cd7 100644
--- a/docs/reference/dependency-injection.md
+++ b/docs/reference/dependency-injection.md
@@ -8,7 +8,7 @@ Most applications should configure DI through the kernel:
 const kernel = new Kernel();
 
 await kernel.dependencyInjection({
-  containerBuild: process.env.NODE_ENV === 'production',
+  containerBuild: process.env.NODE_ENV !== 'production',
 });
 ```
 
diff --git a/docs/reference/kernel.md b/docs/reference/kernel.md
index 85e1b1c..4d09492 100644
--- a/docs/reference/kernel.md
+++ b/docs/reference/kernel.md
@@ -50,7 +50,7 @@ Most applications call this once during startup:
 
 ```ts
 await kernel.dependencyInjection({
-  containerBuild: process.env.NODE_ENV === 'production',
+  containerBuild: process.env.NODE_ENV !== 'production',
   overrides: [],
 });
 ```
@@ -62,6 +62,10 @@ await kernel.dependencyInjection({
 | `servicesYamlPath` | Constructor option or `config/container/services.yaml` | Container YAML path for this compile.                                                            |
 | `sourceDirectory`  | Constructor option or `src`                            | Source tree used when generating the container.                                                  |
 
+Use `containerBuild: true` while generating `services.yaml` from the source
+tree. Production runtimes should usually leave it `false` and load the YAML
+shipped with the application artifact.
+
 Prefer constructor injection in application classes. Use overrides at bootstrap
 or test setup to choose infrastructure.