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:
132
ja/07-plugins/documentation/README.md
Normal file
132
ja/07-plugins/documentation/README.md
Normal 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 Record(ADR)テンプレート
|
||||
|
||||
### 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
|
||||
Reference in New Issue
Block a user