docs: correct the website where it had drifted from the implementation

Several statements were wrong rather than merely thin, and each would have set
the wrong expectation:

- the conversion example implied romaji replaces the input, when the result is
  appended in parentheses and both are sent
- the handshake was described as happening at startup, when it waits for the
  first player to join, so a DISCONNECTED status on an empty server read as a
  fault
- cache eviction was called oldest-first, which the unordered in-memory map
  cannot provide
- the Velocity settings table omitted crossServerDirectMessage
- ConfigManager was described as reading Bukkit's FileConfiguration, and the
  settings storage as recovering from a backup that does not exist

It also documents behaviour that had no mention anywhere: the `!` force-global
prefix, that spy sees channel messages and not only DMs, the nightly build
warnings, the overall 1000ms conversion budget that makes api.timeout above it
ineffective, and the data files the plugin writes.

Co-Authored-By: Claude <noreply@anthropic.com>

1 files changed, 10 insertions, 2 deletions

diff --git a/website/src/ja/docs/features/japanese-conversion.md b/website/src/ja/docs/features/japanese-conversion.md
index b94542e..1cc7d6b 100644
--- a/website/src/ja/docs/features/japanese-conversion.md
+++ b/website/src/ja/docs/features/japanese-conversion.md
@@ -19,8 +19,11 @@ layout: doc
 入力:  konnichiha sekai
 変換1: こんにちは せかい
 変換2: こんにちは 世界
+送信:  konnichiha sekai §e(こんにちは 世界)
 ```
 
+入力した文字列は**置き換えられません**．入力したそのままの文字列を残し，その後ろに変換結果を括弧付きで併記するため，受信側には両方が表示されます．
+
 ## 変換対象
 
 - 通常チャット
@@ -48,7 +51,7 @@ layout: doc
 | `cache.saveIntervalSeconds` | `300` | ディスク保存の間隔 (秒) |
 | `cache.filePath` | `"conversion_cache.json"` | キャッシュファイルのパス |
 
-キャッシュが上限に達すると，古いエントリの10%が自動的に削除されます．
+キャッシュが上限に達すると，エントリの10%が削除されます．どのエントリが削除されるかは規定されていません．メモリ上のキャッシュは順序を持たないため，古い順ではなく実質的に任意のエントリが対象になります．
 
 ## API 設定
 
@@ -56,6 +59,11 @@ Google IME API への接続に関する設定です．
 
 | 設定キー | デフォルト | 説明 |
 |----------|-----------|------|
-| `api.timeout` | `3000` | リクエストタイムアウト (ミリ秒) |
+| `api.timeout` | `3000` | API リクエスト1回あたりのタイムアウト (ミリ秒) |
 
 API がタイムアウトまたは失敗した場合，ひらがなのまま送信されます．
+
+> [!WARNING]
+> `api.timeout` とは別に，1メッセージの変換処理全体に **1000ミリ秒**の上限があります．この上限に達すると変換は中断され，入力したそのままの文字列が (何も併記されずに) 送信されます．
+>
+> 変換全体の上限が `api.timeout` のデフォルト値より短いため，`api.timeout` を `1000` より大きくしても実質的な効果はありません．