Contributing
핵심 개발팀과 커뮤니티의 연락처 정보를 아래에서 찾을 수 있습니다. PX4 프로젝트의 3개 브랜치 Git :
rebase를 통한 발전과정을 보고 Github flow을 피하고자 합니다. 그러나 글로벌 팀과 빠른 개발로 가끔은 merge하기 위해 다시 정렬해야하는 경우도 있습니다.
새로운 기능 개발에 기여하고자 한다면, Github 계정만들고 저장소를 fork하고 새로운 branch 만들고 변경 내용을 추가하고 마지막으로 pull request 보내기를 합니다. 변경 내용이 continuous integration을 통과하면 merge 됩니다.
모든 contribution은 BSD 3-clause 라이센스를 따르며 모든 코드는 반드시 사용에 제약이 없어야 합니다.
커밋과 커밋 메시지 (Commits and Commit Messages)
모든 변경에 대한 커밋 메시지는 커밋 내용을 설명하고 상세하게 기록하도록 합니다. 잘 구조화하면 한줄로 요약할 수 있겠지만 상세하게 설명을 제공하도록 합니다.
Component: Explain the change in one sentence. Fixes #1234
Prepend the software component to the start of the summary
line, either by the module name or a description of it.
(e.g. "mc_att_ctrl" or "multicopter attitude controller").
If the issue number is appended as <Fixes #1234>, Github
will automatically close the issue when the commit is
merged to the master branch.
The body of the message can contain several paragraphs.
Describe in detail what you changed. Link issues and flight
logs either related to this fix or to the testing results
of this commit.
Describe the change and why you changed it, avoid to
paraphrase the code change (Good: "Adds an additional
safety check for vehicles with low quality GPS reception".
Bad: "Add gps_reception_check() function").
Reported-by: Name <[email protected]>
git commit -s를 사용하면 모든 커밋에 사인을 남길 수 있습니다. 마지막 라인에 signed-off-by:과 이름, 이메일을 추가합니다.
커밋 가이드는 Linux Kernel과 리누스 토발즈가 관리하는 프로젝트 의 좋은 예들을 기반으로 하고 있습니다.
비행 결과 테스트 (Tests Flight Results)
비행 테스트는 QA 관점에서 중요합니다. microSD 카드에서 log 파일을 Log Muncher에 업로드하고 비행 결과와 링크를 PX4 Discuss에 공유해 주세요.
포럼과 챗팅
주단위 개발 콜미팅
PX4 개발 팀은 매주 개발관련 내용에 대해서 대화를 나눕니다.
- TIME: Wednesday 5PM CET, 11AM EST, 8AM PDT (subscribe to calendar)
- Uberconference: www.uberconference.com/lf-dronecode
- Phone: +1 415-891-1494
- 아젠더는 미리 PX4 Discuss에 공지
- Issues와 PRs은 devcall로 레이블을 붙여서 토의