php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-13 04:38:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #12339 from bizley/patch-5

Browse Source 
internals PL project organization
This commit is contained in:
Dmitry Naumenko
2016-08-26 10:49:52 +03:00
committed by GitHub
parent d7a1c9033e 070c44f443
commit 36f201763f
1 changed files with 37 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
docs/internals-pl/project-organization.md Normal file
View File

@@ -0,0 +1,37 @@
Organizacja projektu
====================
W tym dokumencie opisana jest organizacja repozytoriów deweloperskich Yii 2.
1. Poszczególne bazowe rozszerzenia i szablony projektów są utrzymywane w oddzielnych *niezależnych* projektach na GitHubie
pod GitHubowym szyldem [yiisoft](https://github.com/yiisoft).
Nazwy repozytoriów rozszerzeń są poprzedzone przedrostkiem `yii2-`, np. `yii2-gii` dla rozszenia `gii`.
Nazwa pakietu composera jest taka sama jak ścieżka repozytorium w Githubie, np. `yiisoft/yii2-gii`.
Nazwy repozytoriów szablonów projektów aplikacji są poprzedzone przedrostkiem `yii2-app-`, np. `yii2-app-basic` dla
szablonu aplikacji `basic`.
Nazwa pakietu composera jest taka sama jak ścieżka repozytorium w Githubie, np. `yiisoft/yii2-app-basic`.
Każde rozszerzenie/projekt aplikacji:
* utrzymuje swoją dokumentację i instrukcje w folderze "docs". Dokumentacja API zostanie wygenerowana w locie, podczas tworzenia nowego wydania.
* utrzymuje swój kod testów w folderze "tests".
* utrzymuje swoje tłumaczenia komunikatów i pozostały istotny meta kod.
* śledzi zgłoszenia w odpowiednim projekcie GitHuba.
Repozytoria rozszerzeń będą wydawane niezależnie w miarę potrzeb, szablony projektów będą wydawane razem z frameworkiem.
Więcej szczegółów znajdziesz w [polityce wersjonowania](versions.md).
2. Projekt `yiisoft/yii2` jest głównym repozytorium deweloperskim frameworka Yii 2.
Repozytorium to utrzymuje pakiet composera [yiisoft/yii2-dev](https://packagist.org/packages/yiisoft/yii2-dev).
Zawiera bazowy kod frameworka, jego testy jednostkowe, przewodnik i zestaw narzędzi przydatnych w procesie tworzenia i wydawania wersji.
Zgłoszenia błędów i nowych funkcjonalności są śledzone w tym projekcie Githuba.
3. Repozytorium `yiisoft/yii2-framework` jest wydzielonym tylko do odczytu folderem `framework` z repozytorium deweloperskiego
i utrzymuje pakiet composera [yiisoft/yii2](https://packagist.org/packages/yiisoft/yii2), który jest oficjalnym pakietem
służącym do instalacji frameworka.
4. Dla ułatwienia procesu deweloperskiego szablony projektów i rozszerzenia mogą zostać dołączone do struktur projektu za pomocą
komendy [build dev/app](git-workflow.md#prepare-the-test-environment).