"RORLa" 오픈소스 프로젝트 매뉴얼

Contribution

: "RORLa" Open Source Project에 기여하기

"로라" 오픈소스 프로젝트는 ROR Lab. 공식 웹사이트(http://rorlab.org)의 리뉴얼 프로젝트로 레일스 프레임워크를 이용하여 API를 만드는 것을 첫번째 목표로 하고 있습니다.

여러분의 참여를 유도하기 위해서 오픈소스 프로젝트로 진행하고 있으며 중간에 기여하는 분들이 쉽게 참여할 수 있도록 지침서를 마련할 필요가 있어 이 문서를 작성합니다.

온라인 협업을 통해 개발을 진행하기 때문에 소스코드관리 툴의 선정이 무엇보다 중요합니다. 다양한 툴이 있지만, 아무래도 GitHub 서비스를 이용하는 것이 가장 손쉽고 이러한 온라인 협업을 위해 최적화된 웹환경이 아마도 최적의 툴로 누구나가 부인하지 못할 것입니다. 이제 GitHub를 소스코드 관리툴로 지정하고 누구라도 저장소를 fork하여 기여할 수 있습니다.

리뉴얼저장소 https://github.com/RORLabNew/rorla_api

로라 프로젝트는 기여자들이 자신의 커밋을 pull request하고 최종 커밋터가 머지하는 방식으로 협업과정을 진행합니다.

  1. 우선, 리뉴얼저장소를 방문하여 우측상단에 있는 Fork버튼을 클릭하면 본인 계정에 로라저장소의 복사본이 만들어 집니다.
  2. 본인의 저장소를 로컬머신에 git clone 하고 일련의 코딩 작업을 진행합니다.
  3. 본인의 로컬머신에서 작업한 내용을 git commit 하고 원격저장소(본인의 GitHub 저장소)로 git push 합니다.
  4. 본인이 작업한 커밋들을 리뉴얼저장소로 머지 요청하는 것을 pull request라고 합니다. 이후로는 pull request를 줄여서 PR이라고 기술하겠습니다. PR 방법은 두가지로 할 수 있습니다. 하나는 GitHub 웹서비스에서 하는 것이고, 다른 하나는 로컬머신의 터미널에서 커맨트라인 명령어로 하는 방법이 있습니다.
  5. 본인이 PR한 것이 최종 머지되지 않는 한 계속해서 PR리스트에 남게 됩니다. 이러한 상황에서 추가 작업한 내용을 커밋/푸시하게 되면 이미 요청한 PR에 푸시된 커밋들이 추가되는 것을 확인할 수 있습니다. 따라서 이전 PR이 머지 되지 않은 상태에서는 또 다른 PR을 요청할 수는 없습니다.
  6. 별도의 작업과정을 구분하고 싶을 때는 로컬머신에서 별도의 git 브랜치를 만들어 작업하고 후에 본인의 PR이 머지될 경우, 작업하고 있는 별도의 브랜치를 머지하면 될 것입니다.
  7. 본인이 요청한 PR을 최종적으로 철회하고자 한다면 페이지 하단에 있는 Close 버튼을 클릭하면 됩니다.