작성자Catalin Pit
오픈 소스 프로젝트에 기여하는 방법 이해
개원 프로젝트에 참여하는 것은 프로그래밍 기술을 향상시키고 지역 사회에 기여하는 좋은 방법이다.또한 개원 프로젝트에 기여한 것이 모두 인코딩을 위한 것이 아니라는 점도 주목할 만하다.너는 다른 방식으로 공헌할 수 있다.예를 들면 다음과 같습니다.

조직 코드

문서 작성 또는 개선

설계자

감사 코드

계속하기 전에, 나는 당신이 행위 준칙과 기부 지침을 읽는 것을 건의합니다.당신의 기대를 설명하기 때문에 투고를 시작하기 전에 자세히 읽어 주십시오.공헌에 필요한 작업 절차도 묘사했다.《개원지침서》에는 이 주제에 관한 좋은 문장이 있다--Your Code of Conduct.
첫 공헌을 할 준비가 되셨나요?자!

1. 아이템 찾기

공헌할 만한 프로젝트를 찾는 것은 어려운 임무이다.나는 네가 어릴 때부터 착수해서 먼저 작은 항목을 선택할 것을 건의한다.왜?작은 프로젝트에서, 일은 더욱 빨리 진전될 뿐만 아니라, 너의 첫 번째 공헌을 얻을 수도 있다.하지만 모험심이 있다면, 더 큰 프로젝트부터 시작할 수 있어!
더 나아가 초보자에게 적합한 프로젝트와 문제를 찾을 수 있는 유용한 사이트가 있다.다음은 상세하지 않은 목록입니다.

goodfirstissues.이 사이트는 첫 번째 투고자에게 적합한 문제만 포함하고 있기 때문에 매우 좋다.초보자에겐프로그래밍 언어와 저장소에 따라 항목을 선택할 수 있습니다.

goodfirstissue.dev- 많거나 적거나 상기 사이트와 같다.'굿 퍼스트 이슈'(Good First Issue)는 유행하는 오픈소스 아이템 중에서 손쉽게 골라 오픈소스에 첫 공헌을 할 수 있도록 도와준다.

준비됐습니다.net-이 사이트는 새로운 공헌자를 위한 프로젝트 목록입니다.

github.com/explore - Github 자체의 탐색 페이지입니다.너는 많은 항목을 찾을 수 있지만, 초보자에게 적합한 문제를 수동으로 검색해야 한다.

이 사이트들은 프로젝트 하나를 찾기에 충분할 것이다.만약 그렇지 않다면, 매일 사용하는 도구를 선택할 수 있고, 만약 그것이 원천을 개척한 것이라면, 당신은 이를 위해 공헌할 수 있다.

2. Git 기본 워크플로우

본고는 Git의 기본 지식을 갖추고 있다고 가정한다.사용할 Git 워크플로우는 다음과 같습니다.

저장소를 GitHub 계정으로 이동합니다.

컴퓨터에서 항목을 복제합니다.

변경 전에 분기를 생성합니다.

를 변경합니다.

변경 사항을 제출하고 추진합니다.

끌어오기 요청을 엽니다.

상술한 작업 절차는 가장 기본적인 작업 절차로 개원 프로젝트에 기여하기에 충분하다.주의해야 할 것은 또 다른 변체가 있다는 것이다.단, 강좌에서 이 옵션을 사용할 것입니다.

3. 프로젝트 완료

완벽한 프로젝트를 찾았다고 가정해 봐.나는 얼마 전에 이 강좌를 위해 만든 OSS-Contribution 저장소를 사용할 것이다.

그림 1
Repository 페이지로 돌아가서 Fork 단추를 누르면 위 그림1과 같다!
왜 먼저 그것을 갈라놓는 것이지, 직접 복제하는 것이 아니냐?프로젝트를 완성할 때, 계정에 복사해야 합니다.따라서 원본 저장소에 영향을 주지 않고 처리할 수 있습니다.포인터는 별도의 복사본을 만들고, 복제는 컴퓨터에서 이 항목을 다운로드합니다.또한 저장소만 복제하면 변경할 수 없습니다.권한을 부여받은 사람만 변경할 수 있다.포인터 항목을 통해 요청을 변경하고 제출할 수 있습니다.
포크가 완성되면 프로젝트 던전으로 다시 지정합니다.지금은 다음 단계로 들어갈 때다.

4. 클론 항목

현재 계정에서 항목을 복제합니다.링크를 찾으려면 저장소 페이지로 이동합니다.

그림 2
분기 저장소 URL을 찾으려면 녹색 버튼Code을 클릭하고 그림 2와 같이 URL을 복사합니다.
링크를 복사한 후 터미널로 이동하여 다음 명령을 실행합니다(URL을 사용자로 바꾸기).

git clone https://github.com/catalinstech/OSS-Contribution.git

저장소가 다운로드될 때까지 기다린 다음 가장 좋아하는 코드 편집기에서 열 수 있습니다.

5. 브랜치 생성

코드 라이브러리를 변경하기 전에 새 지점을 만드는 것이 중요하다.지점은 사람들이 서로 충돌하지 않고 프로젝트에서 일할 수 있도록 허락한다.또한 각 분기는 다른 분기에 독립적이므로 분기의 변경 사항은 병합되지 않는 한 다른 분기에 표시되지 않습니다.
간단하게 말하면, 프로젝트에 대한 변경 사항을 저장합니다.또한 각 항목의 분기 이름 규약을 읽으십시오.모든 항목은 분기의 이름을 지정합니다.예를 들면 다음과 같습니다.

your_name/issue_fix - 예를 들어 catalinpit/add-name-768

issue_number-issue - 예: ET182 손상 복구 네비게이션 막대

그런 다음 새 브랜치를 생성하고 다음과 같이 전환할 수 있습니다.

git branch <your_branch_name>
git checkout <your_branch_name>

또는 다음과 같이 명령에서 동일한 작업을 수행할 수 있습니다.

git checkout -b <your_branch_name>

현재 당신은 이미 새로운 지점을 만들었습니다. 변경할 수 있습니다!다음 섹션으로 이동합니다.

6. 변화를 꾀한다

그림 3
다음 단계는 저장소에서 변경합니다.각 저장소에 따라 변경을 제안할 수 없습니다.
그러나 Github 예시 라이브러리를 사용하면 README 파일에 새로운 트위터 계정을 추가했습니다.이제 변경 사항을 제출하고 추진해야 합니다. 다음 단계에서 완성할 것입니다.

7. 변경 내용 게시

첫 번째 단계는 모든 변경 사항을 임시 영역에 추가하는 것입니다.기본적으로add 명령은 다음 제출 시 특정 파일의 업데이트를 포함한다.그것은 유사 이래 가장 간단한 용어로 'Github에 보내기' 의 내용을 지정했다.
다음 명령 중 하나를 실행합니다.

git add . 

// or

git add README.md (your file name might differ)

git add . 모든 변경 사항을 임시 영역에 추가합니다.예를 들어 10개의 파일을 변경하면 모든 파일이 추가됩니다.다른 한편, 위의 두 번째 버전과 같이 파일 이름을 지정해서 변경 사항을 수동으로 선택할 수 있습니다.지정한 파일만 포함됩니다.

변경 내용 커밋

임시 영역에 업데이트를 포함했지만, 업데이트를 제출해야 합니다.파일을 제출하면 업데이트가 로컬 저장소에 저장됩니다.변경 후 Word 문서를 저장하는 것으로 간주할 수 있습니다.

git commit -m "Added my name to the README"

위에서 git commit 명령의 작용을 볼 수 있습니다."-m"로고는 "메시지"를 대표하며 변경 사항을 총괄할 수 있습니다.이것은 네가 프로젝트에서 무엇을 했는지 묘사해야 한다는 것을 의미한다.가능한 한 제출 메시지가 간결하고 묘사성이 강하도록 해라.동시에 이것은 결코 네가 소설 한 권을 써야 한다는 것을 의미하지 않는다.

당신의 변화를 추진하다

마지막으로 변경 사항을 원격 저장소로 밀어넣습니다.변경 내용은 밀어넣기 전에 로컬 저장소에서만 사용할 수 있습니다.너 자신을 제외하고는 아무도 그것을 볼 수 없다는 것이다.
변경 사항을 추진하려면 다음 명령을 실행합니다.git push -u origin <your-branch-name>너는 지금 거의 다 틀렸어!다음 단계이자 마지막 단계는 Pull 요청을 만드는 것입니다. 다음 장에서 보실 수 있습니다.

8. 끌어오기 요청 열기

그림 4
만약 7단계 7. Publish your changes 의 모든 절차를 따랐다면, 터미널에서pull 요청을 열 수 있는 링크를 얻어야 합니다.그림4(위 그림)는 터미널에서 무엇을 보아야 하는지 설명한다.
어떤 이유로 같은 출력을 얻을 수 없으면 repository URL > Pull requests tab > click on the Compare & pull request로 이동할 수 있습니다.아래 그림 5를 참조하십시오.

그림 5
어떤 옵션을 선택하든지, 드래그 요청을 만들 수 있는 새 창을 열어야 합니다.그림6은 이 점을 설명했다!
하지만 조심해야 돼!인출 요청을 제출하기 전에 공헌 안내서를 읽었는지 확인하세요.최소한 묘사적 제목과 묘사를 추가하십시오!

그림 6
녹색 버튼Create pull request을 누르면 완성됩니다!네가 해야 할 일은 홍보 평론을 기다리는 것이다.잘했어!

당신은 왜 홍보가 필요합니까?

pull 요청을 열면 다른 사람들이 코드 라이브러리에 대한 변경 사항을 볼 수 있습니다.또한 다른 구성원들이 코드 심사를 할 수 있도록 해 줍니다. 이것은 반대로 기능과 코드를 향상시키는 데 도움이 될 수 있습니다.그래서 당신은 가치 있는 피드백을 얻을 수 있습니다!
또한 다음과 같은 여러 가지 이유로 일부 변경 사항이 승인되지 않을 수 있습니다.

코드 품질 저하

비효율성
... 다른 것도 많아요.

드래그 요청을 만들면 코드 라이브러리가 불필요한 추가를 받지 않도록 보호할 수 있습니다.요청 없이 모든 사람이 원하는 내용을 main 지점으로 통합할 수 있다.따라서 코드의 질은 영향을 받을 것이다.
한 마디로 하면pull 요청은 개발자에게 다음과 같은 도움이 되고 허용된다.

고품질 코드 라이브러리

도입(너무 많은) 오류 방지(PRs도 발생할 수 있기 때문)

코드 피드백 받기

그들의 기술과 코드를 향상시킨다

프런트엔드 모니터링

생산 환경에서 웹 응용 프로그램을 디버깅하는 것은 도전적이고 시간도 많이 걸릴 수 있다.Asayer는 사용자가 한 모든 것을 재방송하고 모든 문제에 대한 응용 프로그램의 표현을 보여주는 전방 모니터링 도구입니다.이것은 브라우저의 검사기를 열고 사용자의 어깨를 보는 것과 같다.
Asayer는 문제를 재현하고 JS 오류를 집합하며 응용 프로그램의 성능을 감시할 수 있습니다.Asayer는 Redux나 VueX 저장소의 상태를 포착하고 요청과GraphQL 조회를 검사하는 플러그인을 제공합니다.

즐거움 디버깅, 현대 전단 팀-Start monitoring your web app for free.

결론

가장 기본적인Git 작업 절차를 잘 배웠으니 OSS에 기여할 수 있습니다.그 밖에 만약에 당신이 본문을 따른다면 당신의 첫 번째 기원 공헌도 매우 잘할 것입니다!