Governance
이 문서는 하모나이즈 프로젝트에 참여하고 싶은 기여자들을 위하여 이 프로젝트의 관리가 어떻게 이루어지는지 안내하는 문서입니다.
하모나이즈 프로젝트는 개방적이고 사용자 친화적인 운영을 위해 다양한 채널을 통한 의사소통과 정보를 제공하고 있습니다.
하모나이즈 프로젝트 공식 웹사이트
소스코드 저장소
하모나이즈 프로젝트 마일스톤
커뮤니케이션 채널
이 그룹은 프로젝트의 최종 의사결정 권한을 가지는 그룹입니다. 로드맵, 릴리즈 일정 및 범위, 라이선스 등 프로젝트에 필요한 최종 의사결정을 멤버간 협의하며 정기적인 미팅을 통해 프로젝트의 현황을 공유합니다
Members
- https://github.com/chaeya
- hspark
- tepark
이 그룹은 프로젝트 소스코드에 커밋을 직접 반영할 수 있는 권한을 보유합니다. 컴포넌트별 담당 부문에서 소스코드의 개발과 기여자의 PR을 리뷰하고 마스터 브랜치에 코드를 커밋할 수 있습니다.
Members
- https://github.com/gon1942
- https://github.com/igothere
- https://github.com/jullee96
- https://github.com/yeji0407
- https://github.com/bdh1993
이 그룹은 프로젝트를 위해 프로그램의 소스코드 개선 또는 프로젝트 문서 개선을 제공하는 그룹입니다.
프로젝트 참여하기 전 아래의 문서를 먼저 읽어 보시는 것이 필요합니다.
- 기여자를 위한 행동 강령 규약 : https://github.com/hamonikr/hamonize/blob/master/CODE_OF_CONDUCT.md
- 기여자 라이선스 동의서 : https://github.com/hamonikr/hamonize/blob/master/cla/HamoniKRCLA_ko.md
Members
깃헙 이슈와 wiki, 커뮤니케이션 채널을 통해 개선 제안을 할 수 있습니다.
이 그룹은 프로젝트 소스코드를 이용하는 다양한 분야의 사용자 그룹입니다. 프로그램 사용 중 발견된 이슈를 제공하거나 프로그램 기능 제안 등을 지원하는 그룹입니다.
참여자들의 포럼을 통한 활동으로 프로젝트는 지속적으로 더욱 발전할 수 있습니다.
참여자 포럼 : https://hamonikr.org
프로젝트 사용 중 발생하는 이슈는 아래의 채널을 이용해서 커뮤니케이션 가능합니다.
Wiki를 통해 참여자들의 하모나이즈 프로젝트를 쉽게 이해하고 활용할 수 있도록 합니다.
하모나이즈 프로젝트 Wiki : https://github.com/hamonikr/hamonize/wiki
데모를 통해서 하모나이즈 프로젝트의 결과물과 활용 방안을 확인할 수 있습니다.
데모 사이트 : http://ts.hamonikr.org/
데모 영상 : https://youtu.be/RQ80ABPcMyg
이 프로젝트에 기여를 하고 싶은 경우에는 아래의 문서를 따라서 진행하실 수 있습니다.
- 기여자를 위한 가이드라인 : https://github.com/hamonikr/hamonize/blob/master/CONTRIBUTING.md
이 프로젝트의 주요 의사결정은 Review Board Meeting 을 통해 이루어지며 회의 결과는 아래 링크에서 제공됩니다.
하모나이즈 프로젝트에 발생하는 이슈 및 형상에 대한 관리를 통해 기여자와 참여자 모두 사용하기 편리한 프로젝트를 운영합니다.
프로젝트의 결과물에 대해 문서화함으로써 참여자의 이해를 돕고 능동적인 참여를 할 수 있도록 합니다.
문서화 : https://docs.hamonikr.org/hamonikr/
소스코드 형상관리, 이슈, 기여자의 활동 등 지속적으로 프로젝트 관리를 진행합니다.
소스코드 형상관리 : https://github.com/hamonikr/hamonize
이슈 : https://github.com/hamonikr/hamonize/issues
기여자 활동 : https://github.com/hamonikr/hamonize/graphs/contributors
프로젝트 담당자와 참여자에게 오픈소스 프로젝트에 대한 이해와 직접적인 수행방법,
지속가능한 프로젝트를 위한 유지보수 방안 등에 대해 교육을 진행합니다.
해당 교육자료는 문서화하여 공개하여 필요에 따라 활용할 수 있게 합니다.
오픈소스 컴플라이언스란 오픈소스를 사용하고 개발하는 사람들이 오픈소스의 저작권을 존중하기 위해서 오픈소스의 라이선스 의무를 이행하는 과정입니다.
오픈소스 컴플라이언스 프로세스는 다음과 같습니다.
- 오픈소스 라이브러리 식별
- 소스 코드 감사
- 이슈 확인 및 해결
- 아키텍처 리뷰
- 승인
- 고지
- 검증
이 중, 오픈소스 라이브러리 식별 단계에서는 Olive, Fossa, FOSSID 등의 오픈소스 관리 도구를 활용할 수 있습니다.
하모나이즈 프로젝트는 이 중 Kakao가 공개한 오픈소스 관리 시스템인 Olive 를 통해 라이브러리를 식별, 검증 했습니다.
- olive.kakao.com 에 접속하고, Kakao 계정으로 로그인 한 후, 좌측 상단의 New Project 버튼을 클릭합니다.
- 자신의 github 계정과 연동한 후, 라이브러리 스캔을 진행하고자 하는 저장소를 선택하면 아래와 같은 팝업창이 생성됩니다.
- 브랜치와 소스코드 공개 여부를 선택한 후 확인 버튼을 클릭합니다.
- 아래 이미지와 같이 프로젝트 분석이 시작된 것을 확인할 수 있습니다.
- 해당 프로젝트를 클릭하면 다음과 같이 스캔이 진행 중인 것을 확인할 수 있습니다.
- 스캔 완료시 확인이 필요한 컴포넌트와 라이선스 목록이 제공됩니다. 확인이 필요한 Component 는 자동 매핑되지 않은 컴포넌트 목록을 의미합니다. 이러한 컴포넌트들은 수동으로 각 컴포넌트를 매핑 시키거나, 매핑에서 제외시키는 단계를 진행해야 합니다.
- 상단 메뉴의 Component 를 클릭해 컴포넌트 매핑 페이지로 이동합니다.
- 함께 매핑할 컴포넌트 목록을 모두 체크하고 Mapping 버튼을 클릭합니다.
- 컴포넌트 그룹의 이름을 지정하고 컴포넌트 소유자의 URL, 라이선스, Copyright를 입력한 후, 하단의 확인 버튼을 클릭합니다.
- 라이선스를 매핑하지 않고 스캔에서 제외하고자 하는 컴포넌트가 있다면, 해당 컴포넌트를 체크하고 제외 버튼을 클릭해 스캔에서 제외시킵니다.
- 아래 이미지와 같이 해당 컴포넌트가 스캔에서 제외된 것을 확인할 수 있습니다.
- 다음으로 상단의 Rescan 버튼을 클릭해 프로젝트 스캔을 재진행 합니다.
- 다음과 같이 모든 컴포넌트의 매핑이 완료된 것을 확인합니다.
- 다음으로, 상단의 License를 클릭해 스캔된 라이선스 중 확인이 필요한 라이선스 목록을 체크합니다.
- 확인이 필요한 라이선스 항목은 빨간색으로 출력됩니다. 각각을 클릭해 해당 라이선스에 대해 취할 조치를 지정해야 합니다.
- 아래 이미지와 같이 해당 라이선스에 대해 취할 수 있는 조치 중 원하는 오픈소스 사용 방법을 선택하고 확인 버튼을 클릭합니다.
- 각 라이선스마다 취할 수 있는 조치가 다르기 때문에 본인의 프로젝트의 소스코드 공개 여부 등 여러가지 사항을 고려해야 합니다.
- 확인이 필요한 라이선스 목록 각각에 대해 모두 오픈소스 사용 방법을 지정 완료하면 아래 이미지와 같이 라이선스의 확인이 모두 완료된 것을 확인할 수 있습니다.
- 컴포넌트 매핑과 라이선스 확인 단계를 모두 완료했으므로 우측 상단의 Complete 버튼을 클릭해 프로젝트 라이브러리 검증을 완료합니다.
- 상단의 Report 를 클릭해 레포트 페이지에서 검증 내역과 체크리스트를 확인합니다.
- Report 페이지 하단의 고지문을 클릭해, 프로젝트 검증 결과 산출물인 고지문을 다운로드 받습니다. 우측 상단의 MD 버튼을 클릭하면 notice.md 파일이 다운받아 집니다. 자신의 github 저장소의 최상단 경로에 NOTICE.md 와 같은 이름으로 해당 파일을 업로드해 라이선스 고지 의무를 지키도록 합니다.
