오픈소스 주소모아, 커뮤니티에 처음 참여하는 사람을 위한 안내

오픈소스 주소모아, 커뮤니티에 처음 참여하는 사람을 위한 안내

매일 쓰는 브라우저와 앱 속에는 누군가 공개해 둔 오픈소스 코드가 들어 있습니다. 오픈소스 커뮤니티는 코드를 고치는 사람뿐 아니라 오류를 알리고 문서를 다듬는 사람 모두에게 열려 있습니다. 처음 참여하는 분을 위해 알아 둘 낱말과 순서를 정리했습니다.

먼저 알아 둘 낱말

  • 저장소: 프로젝트의 코드와 문서, 변경 기록이 모인 곳입니다. GitHub에 많은 저장소가 공개되어 있습니다.
  • 이슈: 오류 신고나 기능 제안을 남기는 게시판입니다.
  • 풀 리퀘스트: 내가 고친 내용을 프로젝트에 반영해 달라고 요청하는 것입니다.
  • 라이선스: 코드를 어떤 조건으로 쓰고 고치고 배포할 수 있는지 정한 약속입니다.
  • 기여 안내: 프로젝트마다 참여 방법을 적어 둔 문서로, 흔히 CONTRIBUTING이라는 이름입니다.

라이선스부터 읽습니다

오픈소스라고 해서 아무 조건 없이 쓸 수 있는 것은 아닙니다. MIT, Apache 2.0, GPL처럼 라이선스마다 출처 표시, 변경 내용 공개, 같은 라이선스 유지 같은 조건이 다릅니다. 라이선스의 차이를 쉽게 정리한 Choose a License와 라이선스 목록을 관리하는 오픈소스 이니셔티브에서 기본 개념을 확인할 수 있습니다. 회사 프로젝트에 오픈소스를 쓴다면 회사의 정책도 함께 확인해야 합니다.

처음 참여하는 순서

  1. 자주 쓰는 도구의 공식 저장소를 찾습니다. 공식 사이트에 적힌 저장소 링크를 따라가면 정확합니다.
  2. 기여 안내와 행동 강령 문서를 읽습니다.
  3. 처음 참여하는 사람에게 권하는 표시가 붙은 이슈를 찾아봅니다.
  4. 오류를 알릴 때는 사용한 버전, 재현 방법, 기대한 결과와 실제 결과를 적습니다.
  5. 문서의 오타 수정처럼 작은 풀 리퀘스트부터 시작합니다.

깃과 GitHub 사용법은 GitHub 문서에 한국어로 정리되어 있습니다. 깃은 공식 설치처인 Git에서 받습니다. 개발 도구를 안전하게 설치하는 법은 개발 도구 공식 설치처 확인하기에 있습니다.

패키지 저장소를 쓸 때

오픈소스 라이브러리는 npm 레지스트리나 PyPI 같은 패키지 저장소에서 내려받습니다. 누구나 올릴 수 있는 곳이라 유명 패키지와 이름이 비슷한 가짜 패키지가 올라오는 일이 있습니다. 설치 명령을 복사하기 전에 패키지 이름을 공식 문서와 대조하고, 저장소 링크와 최근 업데이트를 확인하세요. 아파치 소프트웨어 재단처럼 큰 재단이 관리하는 프로젝트는 재단 공식 사이트에서 프로젝트 목록과 공식 저장소를 확인할 수 있습니다.

국내에서 함께 배우기

국내 기업 기술 블로그에는 오픈소스를 공개하거나 기여한 경험담이 자주 올라옵니다. 네이버 D2, 카카오 기술 블로그, 토스 테크에서 오픈소스 관련 글을 찾아보면 실제 사례를 배울 수 있습니다. 공식 주소는 웹·IT 우편함에 모아 두었습니다.

보안 공지를 챙기는 습관

오픈소스 라이브러리에서도 보안 취약점이 발견됩니다. 프로젝트는 보안 공지나 릴리스 노트로 문제를 알리고 고친 버전을 내놓습니다. 내가 쓰는 라이브러리의 저장소에서 릴리스 알림을 받도록 설정해 두면 업데이트 소식을 놓치지 않습니다. GitHub에는 저장소의 의존성에서 알려진 취약점을 알려 주는 기능도 있습니다.

국내 보안 소식은 KISA 보호나라의 보안 공지에서도 확인할 수 있습니다. 널리 쓰이는 오픈소스에 큰 취약점이 알려지면 업데이트 권고가 올라오기도 합니다. 업데이트 파일은 공지에 적힌 공식 경로에서만 받습니다.

행동 강령을 지키는 이유

많은 오픈소스 프로젝트는 서로 존중하며 소통하자는 행동 강령을 둡니다. 이슈와 리뷰에서 오가는 말은 공개 기록으로 남고, 전 세계 사람들이 함께 읽습니다. 다른 사람의 코드를 고칠 때도 왜 그렇게 고쳤는지 차분히 설명하고, 받은 의견에는 고마움을 표하는 것이 좋습니다. 이런 태도가 쌓이면 프로젝트 안에서 신뢰를 얻고 더 큰 기여로 이어집니다.

처음 기여한 풀 리퀘스트가 바로 받아들여지지 않더라도 실망할 필요는 없습니다. 관리자가 수정을 요청하면 의견에 맞춰 고쳐 다시 올리면 되고, 받아들여지지 않더라도 그 과정에서 프로젝트의 규칙과 코드 스타일을 배우게 됩니다. 작은 기여를 여러 번 이어 가다 보면 자연스럽게 더 큰 일을 맡게 됩니다.

오픈소스를 쓰기만 하던 회사나 팀이라면 쓰고 있는 라이브러리 목록과 라이선스를 한 번 정리해 보는 것도 좋습니다. 어떤 프로젝트에 기대고 있는지 알면 보안 공지와 업데이트를 챙기기도 쉬워집니다.

레터 끝 질문

코드를 잘 못 써도 참여할 수 있나요?

문서 번역, 오타 수정, 오류 신고, 사용 후기처럼 코드가 아닌 기여도 프로젝트에 큰 도움이 됩니다. 기여 안내에서 환영하는 기여 종류를 확인해 보세요.

오픈소스 코드를 내 프로젝트에 그대로 써도 되나요?

라이선스 조건을 지키면 쓸 수 있습니다. 출처 표시나 라이선스 사본 포함 같은 조건이 있는지 라이선스 파일을 먼저 읽으세요.

이슈에 답이 오지 않아요.

오픈소스는 자원봉사로 운영되는 경우가 많아 답이 늦을 수 있습니다. 재촉하기보다 재현 방법을 보충하거나, 비슷한 이슈가 이미 있는지 찾아보세요.