Github 100% 활용하기 - XE Open seminar #3
1 like420 views
XE3 Github 저장소에 문의하고 기여하는 방법부터 효율적으로 사용하는 방법까지
Github 100% 활용하기 - XE Open seminar #3
- 1. 커뮤니티 참여와 Github 사용 팁 Github 100% 활용
- 2. 버전관리 시스템 Git 버전관리 시스템의 저장소를 제공하는 서비스 무료로 사용할 수 있는 공개형 저장소와 유료로 사용해야하는 비공개 저장소 제공 PRODUC T OWNER GitHub
- 3. 왜 Github에 대한 얘기를 하나? • 지금 우리가 사용하는 대부분의 코드는 Github에 있다 • 나도 모르는 사이에 Github에 있는 소스코드를 이미 사용하고 있다 • 내가 사용하는 코드에 문제가 있을 때 어디에 물어봐야 하나? • 내가 사용하는 코드의 문제점을 해결했을 땐, 그 다음으로 무엇을 하면 좋을까?
- 4. 여기서 잠깐 토론에 대해서 • 국내 문화와 인터넷 커뮤니티 • 국내에서 자주 언급되는 토론 문화의 성숙도 • 토론이 감정적으로 치달아 문제되는 경우가 자주 발생함 • 비평, 비판, 비난 • 토론에서 나와 다른 의견이 제시 될 때 이것을 잘 구분 하는가 • 남의 비난을 두려워 하고 있지 않은가? • 국내 Github 프로젝트 참여자 수 • 단순히 언어의 장벽과 인구 수에 의한 차이일까? • 프로젝트 커뮤니티 참여를 가로막는 보이지 않는 벽은 무엇일까?
- 5. 경험 - PR & 까임 Laravel 저장소에 Pull Request 를 보내 봤습니다. 누군가 "그게 왜 필요해?" 라고 물어봤고 저는 한국에 있으니까 자고 있었구요. 다음날 출근해서 보니까 "하던대로 하자" 는 마지막 대화로 이슈가 닫혔습니다.
- 6. 의견이 받아 들여 지지 않았을 때? • 조금 많았던 서운한 감정 • 생각 많이하고 고민해서 보냈는데, 너무 쿨하게 까였음 • 어떤 문제였을까? (의식의 흐름) • '질문이 잘못 되었는가?' 에 대해서 생각해봄 • 의견에 대한 명확하고 타당한 근거를 제시하지 못함 • 내 의견을 제시할 때 상대방을 설득하려는 노력이 필요했다
- 7. 결론 • 국외 커뮤니티에서 언어에 대한 장벽 실감함 • 의견 제시하기 전에 너무 많은 고민 • 간단한 의견 임에도 상당한 시간이 걸렸음 • 듣는 사람이 내 의견을 이해하지 못했다면 좀더 명확하게 얘기할 수 있도록 하자 • 한번 해보니까 대단한 일이 아니었다 • 까이는게 뭐 큰일인가!?
- 8. Github 토글 버튼 Watch/Unwatch : 지켜봄 (알림 등 메시지 받음) Start/Unstart : 좋아요! Fork : 퍼감, Copy, Github의 내 저장소에 복사 관심 갖는 프로젝트에 마구마구 사랑을 나눠 주세요. 운영자는 더욱 힘이 날꺼에요!
- 9. Github 탭 메뉴 Code : 프로젝트의 코드를 볼 수 있음 Issue : 문의하기 게시판 (이정도로 생각하고 사용 해도 됨) Pull Request(PR) : 당김 요청 (내가 수정한 내용 을 보내서 프로젝트에 반영되길 바랄 때 사용) 다른 탭 메뉴는 눌러보세요.
- 10. Code 페이지 수치 Commits : 코드 커밋 수 Branch : 가지 치기 수 Releases : 배포 버전 수 Contributors : 기여자 수
- 12. Issue, Pull Request • 모든 프로젝트는 사용자 참여를 기다리고 있음 • 질문, 개선사항을 남겨서 프로젝트를 발전 시킬 수 있음 • Pull Request 를 통해 프로젝트에 기여할 수 있음
- 13. XE3 Issue 의 Labels https://github.com/xpressengine/xpressengine/issues/new XE3 저장소의 라벨을 보고 Issue 에는 어떤 내용을 남기면 될지 얘기해 보겠습니다. * type/ bug, enhancement, proposal, question, security * 오류, 개선, 제안, 문의, 보안 * status/ duplicated, invalid, keep, need-more-info, now-checking, wontfix, works- for-me * 중복됨, 유효하지 않음, 보류됨, 추가정보필요, 확인중, 누가 고쳐주길 바래, 대신 누가 해줘ㅜㅜ 이슈에 남길 수 있는 내용은 오류, 개선, 제안, 문의, 보안 에 대한 내용 입니다. 커뮤니티에 따라 다르겠지만 GitHub 에 Issue 를 운영하는 프로젝트는 거의 같은 분류를 취 급합니다.
- 14. GitHub Issu VS 공홈 Q&A GitHub Issue 도 충분히 묻고답하기 게시판 기능을 수행할 수 있음 비슷한 기능의 커뮤니티를 두군데 운영하는 이유는 국내 사용자가 GitHub 사용을 익숙해 하지 않는다고 판단했기 때문 XE팀은 GitHub Issue 로 문의하길 권장함
- 15. GitHub Issue 에서 의견 교류
- 16. Pull Request • Pull Request(PR) 은 내가 수정한 코드를 프로젝트에 반영 시키는 수단 • 프로젝트 운영자에게 "당김 요청"을 보내는 것 • 수정한 Commit, 내용을 보내는게 아니라 프로젝트 운영자가 당겨갈 Branch 를 보내는 것 • 프로젝트 운영자가 내 저장소의 Branch 를 당겨간 다는 의미를 정확히 해야함
- 17. PR 보내는 법 • https://github.com/xpressengine/xpressengine/blob/master/.github/CONTRIBUTING.md • XE3 저장소에 있는 Contributing 가이드
- 18. Web Hook!
- 19. Webhooks • https://developer.github.com/webhooks/ • GitHub 에서 제공되는 기능 • GitHub 저장소에 이벤트가 발생하면 등록된 기능 실행
- 20. XE3 Webhooks setting • https://scrutinizer-ci.com/ • 외부 서비스에 issue, comment, PR 등 새로운 이벤트가 생기면 실행되도록 해서 Slack 으로 메시지 전송 • 오픈소스는 무료 지원 • bitbucket 저장소와 싱크 맞추기 기능 • 오픈소스 기반으로 private 저장소를 운영해야할 경우 • Jenkins 연동 • 새로운 push 들어오면 unit-test 실행, code-style 체크
- 21. Jenkins 연동 GitHub Jenkins Slack Push Job : Unit Test Job : Code Style 메시지 전송 XE 팀 Slack
- 22. Jenkins Job for check code style
- 24. GitHub 가격 정책
- 25. 회사 코드는 공개 되면 안되!! 그렇다고 돈내고 쓰기도 좀 그런데 ;;
- 26. 비공개 저장소
- 27. Yona • 국내 오픈소스 • Yobi 프로젝트에서 이름을 바꾸서 Yona 프로젝트 진행 • 한국어로 지원되어 사용할 때 편리한 잇점 • 설치형 • 무제한의 프로젝트, 무제한의 사용자 • Git Respository 기능 • 이슈, 게시판 기능 • 회원, 그룹 관리 기능
- 28. Yona 설치 화면
- 29. T h a n k y o u X E H U B