docs(web): update LSP docs wording (#29435)

Co-authored-by: starptech <starptech@starptechs-MBP.fritz.box>

packages/web/src/content/docs/ja/lsp.mdx

@@ -3,7 +3,7 @@ title: LSPサーバー
 description: OpenCode は LSP サーバーと統合します。
 ---
 
-OpenCode は言語サーバープロトコル (LSP) と統合して、LLM がコードベースと対話できるようにします。診断を使用して LLM にフィードバックを提供します。
+OpenCode は Language Server Protocol (LSP) サーバーと統合し、診断を agent へのフィードバックとして使用できます。
 
 ---
 
@@ -47,7 +47,7 @@ OpenCode には、一般的な言語用のいくつかの組み込み LSP サー
 | yaml-ls            | .yaml, .yml                                                         | Auto-installs Red Hat yaml-language-server                   |
 | zls                | .zig, .zon                                                          | `zig` command available                                      |
 
-上記のファイル拡張子のいずれかが検出され、要件が満たされると、LSP サーバーは自動的に有効になります。
+LSP はデフォルトで無効です。有効にすると、上記のファイル拡張子のいずれかが検出され、要件が満たされた場合にサーバーが起動します。
 
 :::note
 `OPENCODE_DISABLE_LSP_DOWNLOAD` 環境変数を `true` に設定すると、LSP サーバーの自動ダウンロードを無効にできます。
@@ -57,16 +57,35 @@ OpenCode には、一般的な言語用のいくつかの組み込み LSP サー
 
 ## 仕組み
 
-OpenCode がファイルを開くと、次のようになります。
+LSP が有効で OpenCode がファイルを開くと、次のようになります。
 
 1. 有効なすべての LSP サーバーに対してファイル拡張子をチェックします。
 2. 適切な LSP サーバーがまだ実行されていない場合は開始します。
 
 ---
 
+## ベストプラクティス
+
+LSP は、言語サーバーの診断を提供することで、agent が問題を見つけて修正する助けになります。これは一部のプロジェクトで有用ですが、常に明確な利点になるとは限りません。
+
+言語サーバーは同期が外れたり、多くのメモリを使用したり、バージョンやプロジェクトによって挙動が変わったり、agent のワークフローを遅くすることがあります。多くのプロジェクトでは、agent に lint、typecheck、その他の診断用 CLI ツールを直接実行させる方が適しています。これにより、これらのトレードオフを避けながら、エラーを agent のループに戻せます。追加の言語サーバーフィードバックが有効な場合に LSP を有効にしてください。
+
+---
+
 ## 設定
 
-OpenCode 設定の `lsp` セクションを通じて LSP サーバーをカスタマイズできます。
+OpenCode 設定の `lsp` セクションを通じて LSP サーバーを有効化し、カスタマイズできます。
+
+すべての組み込み LSP サーバーを有効にするには、`lsp` を `true` に設定します。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": true
+}
+```
+
+オブジェクトを使用すると、組み込みサーバーを有効にしたまま、上書き設定やカスタムサーバーを設定できます。
 
 ```json title="opencode.json"
 {
@@ -135,7 +154,7 @@ LSP サーバーの起動時に `env` プロパティを使用して環境変数
 
 ### LSPサーバーの無効化
 
-**すべて** LSP サーバーをグローバルに無効にするには、`lsp` を `false` に設定します。
+`lsp` を省略すると、すべての LSP サーバーは無効になります。別の設定で有効化されたすべての LSP サーバーを無効にするには、`lsp` を `false` に設定します。
 
 ```json title="opencode.json" {3}
 {