project-organization.md

プロジェクトの編成

このドキュメントは Yii 2 開発レポジトリの編成を説明するものです。

1. 個々のコア・エクステンションとアプリケーション・テンプレートは、yiisoft Github オーガニゼーションの下の 独立した 別の Github プロジェクトとして保守されます。

   エクステンションのレポジトリ名は、先頭に yii2- を付けます。例えば、gii エクステンションは yii2-gii です。 Composer のパッケージ名は Github レポジトリ名と同じで、例えば yiisoft/yii2-gii です。

   アプリケーション・テンプレートのレポジトリ名は、先頭に yii2-app- を付けます。例えば、basic アプリケーション・テンプレートは yii2-app-basici です。 Composer のパッケージ名は Github レポジトリ名と同じで、例えば yiisoft/yii2-app-basic です。

   各々のエクステンション/アプリケーションのプロジェクトは、

   • "docs" フォルダにおいてそのチュートリアル・ドキュメントを保守します。API ドキュメントは、エクステンション/アプリケーションがリリースされるときにその場で生成されます。
   • "tests" フォルダにおいてそれ自身のテスト・コードを保守します。
   • それ自身のメッセージ翻訳やその他全ての関係するメタコードを保守します。
   • 対応する Github プロジェクトによって、課題 (issue) を追跡します。

   エクステンションのレポジトリは、必要に応じて、個別にリリースされます。アプリケーション・テンプレートはフレームワークとともにリリースされます。 詳細は バージョン・ポリシー を参照して下さい。

2. yiisoft/yii2 プロジェクトが、Yii 2 フレームワーク開発のためのメイン・レポジトリです。 このレポジトリは Composer パッケージ yiisoft/yii2-dev を提供します。 これは、コア・フレームワーク・コード、フレームワークの単体テスト、決定版ガイド、そして、フレームワーク開発とリリースのための一組のビルド・ツールを含んでいます。

   コア・フレームワークのバグと機能要望は、この Github プロジェクトのイッシュー・トラッカーによって追跡されます。

3. yiisoft/yii2-framework レポジトリは、開発プロジェクト・レポジトリの framework ディレクトリのリード・オンリーな git subsplit です。 このレポジトリが、フレームワークのインストールに使用される Composer 公式パッケージである yiisoft/yii2 を提供します。

4. 開発するときには、build dev/app コマンドを使って、 アプリケーションとエクステンションを開発プロジェクトの構成に含めることが出来ます。