feat(i18n): Add Japanese (ja/) translation (#105)

- Translate all 101 markdown files: P1 core, all 10 modules, examples,
  auxiliary docs (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, CLAUDE.md, etc.),
  peripheral docs (.github/, docs/, resources/, scripts/)
- Translate comments and user-facing messages in 06-hooks/*.sh examples
- Copy 05-mcp/*.json examples (standard JSON, no comments)
- Update root README.md language switcher to include 日本語
- Add ja/TRANSLATION_NOTES.md (glossary + style guide)

All translations pass pre-commit quality gates (markdown-lint,
cross-references, mermaid-syntax, link-check, build-epub).
This commit is contained in:
JiangCheng
2026-04-30 07:16:46 +09:00
committed by GitHub
parent 32212292df
commit 1d1df9235b
118 changed files with 30380 additions and 3 deletions

View File

@@ -0,0 +1,132 @@
<!-- i18n-source: 07-plugins/documentation/README.md -->
<!-- i18n-source-sha: d17d515 -->
<!-- i18n-date: 2026-04-27 -->
<picture>
<source media="(prefers-color-scheme: dark)" srcset="../../resources/logos/claude-howto-logo-dark.svg">
<img alt="Claude How To" src="../../resources/logos/claude-howto-logo.svg">
</picture>
# Documentation プラグイン
プロジェクトのドキュメント生成と保守を包括的に行うプラグイン。
## 機能
✅ API ドキュメント生成
✅ README の作成と更新
✅ ドキュメント同期
✅ コードコメントの改善
✅ サンプルコード生成
## インストール
```bash
/plugin install documentation
```
## 同梱内容
### スラッシュコマンド
- `/generate-api-docs` — API ドキュメントを生成
- `/generate-readme` — README を作成または更新
- `/sync-docs` — コード変更にドキュメントを同期
- `/validate-docs` — ドキュメントを検証
### サブエージェント
- `api-documenter` — API ドキュメンテーションのスペシャリスト
- `code-commentator` — コードコメントの改善
- `example-generator` — コード例の作成
### テンプレート
- `api-endpoint.md` — API エンドポイントのドキュメントテンプレート
- `function-docs.md` — 関数ドキュメントのテンプレート
- `adr-template.md` — Architecture Decision RecordADRテンプレート
### MCP サーバー
- ドキュメント同期のための GitHub 連携
## 使い方
### API ドキュメントを生成
```
/generate-api-docs
```
### README を作成
```
/generate-readme
```
### ドキュメントを同期
```
/sync-docs
```
### ドキュメントを検証
```
/validate-docs
```
## 必要要件
- Claude Code 1.0 以上
- GitHub アクセス(任意)
## ワークフロー例
```
User: /generate-api-docs
Claude:
1. Scans all API endpoints in /src/api/
2. Delegates to api-documenter subagent
3. Extracts function signatures and JSDoc
4. Organizes by module/endpoint
5. Uses api-endpoint.md template
6. Generates comprehensive markdown docs
7. Includes curl, JavaScript, and Python examples
Result:
✅ API documentation generated
📄 Files created:
- docs/api/users.md
- docs/api/auth.md
- docs/api/products.md
📊 Coverage: 23/23 endpoints documented
```
## テンプレートの使い方
### API Endpoint テンプレート
REST API エンドポイントを完全な例つきでドキュメント化する。
### Function Documentation テンプレート
個々の関数 / メソッドのドキュメント化に使う。
### ADR テンプレート
アーキテクチャ判断のドキュメント化に使う。
## 設定
ドキュメント同期用の GitHub トークンを設定する:
```bash
export GITHUB_TOKEN="your_github_token"
```
## ベストプラクティス
- ドキュメントはコードの近くに置く
- コード変更とともにドキュメントも更新する
- 実用的な例を含める
- 定期的に検証する
- 一貫性のためにテンプレートを使う
---
**最終更新**: 2026 年 4 月 24 日
**Claude Code バージョン**: 2.1.119
**出典**:
- https://code.claude.com/docs/en/plugins
- https://github.com/anthropics/claude-code/releases/tag/v2.1.119
**対応モデル**: Claude Sonnet 4.6、Claude Opus 4.7、Claude Haiku 4.5