Add errors and warnings troubleshooting page

manuals/1.0/en/troubleshooting/errors.md

@@ -0,0 +1,52 @@
+---
+layout: docs-en
+title: Errors and Warnings
+category: Manual
+permalink: /manuals/1.0/en/troubleshooting/errors.html
+---
+
+# Errors and Warnings
+
+This page indexes BEAR.Sunday runtime diagnostics by domain exception class or
+warning message.
+
+## Exceptions
+
+### `BEAR\Package\Exception\InvalidCliContextException`
+{: #invalid-cli-context-exception }
+
+Thrown when the CLI context receives server data without CLI arguments.
+
+This usually means a web request was routed through the CLI context. Use a
+non-CLI context for web requests, and use the CLI context only for console
+entrypoints.
+
+Parent exception:
+
+```text
+BEAR\Package\Exception\InvalidContextException
+```
+
+## Warnings
+
+### Injector Cache Warning
+{: #injector-cache-warning }
+
+Message:
+
+```text
+Failed to cache the injector(...). The cache adapter could not store the item.
+```
+
+`PackageInjector` stores compiled injectors in the configured cache adapter and
+then reads the item back to verify that it can be restored.
+
+If the warning includes `Serialization failed:`, the injector or the root object
+graph generated by bootstrap contains an object that cannot be serialized. Fix
+the object graph so that the compiled injector can be serialized.
+
+If serialization succeeds but the cached item cannot be restored, the cache
+adapter or runtime environment did not store the item as expected. Check that
+the configured cache adapter is persistent and available in the current runtime
+context. This can happen with non-persistent adapters such as `NullAdapter`, or
+cache backends that are unavailable in the current runtime context.

manuals/1.0/ja/troubleshooting/errors.md

@@ -0,0 +1,55 @@
+---
+layout: docs-ja
+title: エラーと警告
+category: Manual
+permalink: /manuals/1.0/ja/troubleshooting/errors.html
+---
+
+# エラーと警告
+
+このページでは、BEAR.Sunday の実行時診断をドメイン例外クラス名または
+警告メッセージから探せるように整理します。
+
+## 例外
+
+### `BEAR\Package\Exception\InvalidCliContextException`
+{: #invalid-cli-context-exception }
+
+CLI コンテキストが CLI 引数を持たない server data を受け取ったときに
+投げられます。
+
+通常は、Web リクエストが CLI コンテキストで処理されていることを意味します。
+Web リクエストには非 CLI コンテキストを使い、CLI コンテキストはコンソール
+エントリーポイントにだけ使ってください。
+
+親例外:
+
+```text
+BEAR\Package\Exception\InvalidContextException
+```
+
+## 警告
+
+### インジェクターキャッシュ警告
+{: #injector-cache-warning }
+
+メッセージ:
+
+```text
+Failed to cache the injector(...). The cache adapter could not store the item.
+```
+
+`PackageInjector` はコンパイル済みインジェクターを設定されたキャッシュ
+アダプターに保存し、その項目を読み戻して復元できることを確認します。
+
+警告に `Serialization failed:` が含まれる場合、インジェクターまたは
+bootstrap が生成したルートオブジェクトグラフにシリアライズできない
+オブジェクトが含まれています。コンパイル済みインジェクターを
+シリアライズできるように、オブジェクトグラフを修正してください。
+
+シリアライズには成功しているのにキャッシュ項目を復元できない場合、
+キャッシュアダプターまたは実行環境が期待どおりに項目を保存していないことを
+意味します。設定されたキャッシュアダプターが永続化可能で、現在の実行
+コンテキストで利用できることを確認してください。`NullAdapter` のような
+永続化しないアダプターや、現在の実行コンテキストで利用できない
+キャッシュバックエンドで発生します。