기여 가이드(Contribution Guide)
버그 리포트
활발한 협력을 장려하기 위해, 라라벨은 버그 리포트가 아니라 PR을 권장하고 있습니다. "버그 리포트"는 실패한 단위 테스트를 포함한 PR로 보내져야 합니다.
버그 리포트를 작성하는 경우, 이슈는 제목과 이슈에 대한 명확한 설명을 포함해야 합니다. 또한, 해당 이슈에 대한 가능한 많은 관련 정보와 데모 코드 샘플을 포함해야 합니다. 버그 리포트의 목적은 여러분 자신과 그리고 다른 사람들도 쉽게 버그를 재현 할 수 있도록 하고 버그가 수정되도록 하는 것입니다.
명심할 것은 버그 리포트가 같은 문제에 있던 다른 사람들과 문제를 해결하기 위해 협력 할 수 있는 기회을 만든다는 것입니다. 버그 리포트를 통해 자동으로 뭔가가 일어나고, 다른 누군가가 문제를 해결하기를 기대하지 마십시오. 버그 리포트 제출은 여러분 자신과 다른 사람이 문제를 해결하는 길을 시작하는 계기가 되는 것입니다.
라라벨의 소스 코드는 GitHub에서 관리되며 각각의 라라벨 프로젝트의 저장소가 있습니다:
- Laravel Framework 라라벨 프레임워크
- Laravel Application 라라벨 어플리케이션
- Laravel Documentation 라라벨 매뉴얼
- Laravel Cashier 라라벨 캐셔
- Laravel Envoy 라라벨 Envoy
- Laravel Homestead 라라벨 Homestead
- Laravel Homestead Build Scripts 라라벨 Homestead 빌드 스크립트
- Laravel Website 라라벨 웹사이트
- Laravel Art 라라벨 아트웤
핵심기능에 대한 개발 논의
버그에 대한, 새로운 기능 및 기존 기능의 구현에 대한 논의는 Freenode의 #laravel-dev IRC 채널에서 진행하고 있습니다. 라라벨의 메인 관리자 인 Taylor Otwell는 일반적으로 평일 오전 8시부 터5 시까 지 (America / Chicago 표준시 UTC-06 : 00 기준) 접속해 있고, 그외에 다른 시간대에는 가끔 접속합니다.
#laravel-dev IRC 채널은 모든 사람에게 개방되어 있습니다. 토론에 참여하거나, 혹은 그냥보고 있는 것만으로도 괜찮습니다, 채널에 많이 참가하세요!
브랜치 선택
모든 버그 수정은 최신 안정 브랜치에 보내져야 합니다. 다음 릴리스에만 존재하는 기능에 대한 수정사항이 아니라면 버그 수정사항을 master 브랜치에 절대 보내지 마십시오.
현재 라라벨 릴리스와 완전히 거꾸로 겸용성을 가진 작은 기능은 최신 안정 브랜치로 보내 주시기 바랍니다.
다음 라라벨 릴리즈에 포함될, 새로운 기능들은 항상 master 브랜치로 보내 주시기 바랍니다.
만약 여러분의 새로운 기능이 메이저인지 마이너인지 명확하지 않다면 Freenode의 #laravel-dev IRC 채널에서 Taylor Otwell에 문의 하길바랍니다.
보안 취약점
만약 라라벨에서 보안 취약점을 발견했다면 테일러 오트웰 taylor@laravel.com에게 이메일을 보내주시길 바랍니다. 모든 보안 취약점은 신속하게 해결될 것입니다.
코딩 스타일
라라벨은 PSR-4와 PSR-1 코딩 표준을 따르고 있습니다. 이러한 기준에 더하여, 다음과 같은 코딩 표준을 따라야 합니다.
- 클래스 네임스페이스는 반드시
<?php와 같은 라인에 있어야 합니다. - 클래스를 여는
{는 반드시 클래스 이름과 같은 라인에 있어야 합니다. - 함수와 컨트롤 구조에서는 반드시 Allman 방식의 괄호를 구성합니다.
- 인덴트는 탭으로, 정렬은 스페이스로 구성합니다.