SOS-Practice (Tutorial)

Make open sources friendlier, Make people participate, Make people get involved into SOS-Masters Program and Other open source project.

Getting Started

• Prerequisite

$ pip3 install PyQt5 pyqt5-tools

• How to Run

$ python3 main.py

Git Commit Rule

- Git Commit Rule을 꼭 지켜주세요!

• Git Commit Rule은 앞으로 여러분께서 다른 오픈소스에 컨트리뷰트하실 때에도 꼭 지켜주셔야 하는 하나의 약속입니다.
• Git Commit Rule은 오픈소스 레포지토리마다 큰틀에서는 비슷하나 조금씩 상이할 수 있으니 해당 오픈소스 룰을 따라 주시면 됩니다.
• Git Commit Rule: 꼭 읽어주세요!

How to Start?

- Good First Issue를 먼저 읽어보시는 걸 추천드립니다.

• Good First Issue
• 위 링크를 타고 가시거나, Issue 탭에서 직접 원하는 이슈를 골라도 됩니다.
• 혹은, 이슈 탭에 자신이 원하는 이슈가 없다면, 본인이 직접 이슈를 작성하셔도 됩니다!
• 단, 되도록 이슈와 PR은 모두 영어로 작성해주셔야 합니다. (이는 타 오픈소스도 Global한 진행을 위해 필수입니다!)

- 그 후, 문제를 해결하신 후에 Git Commit을 진행해주세요.

• Git Commit을 하기 위해서, 우선 이 레포지토리를 Fork 해주세요. (Fork는 Star 버튼 옆에 있습니다.) -(https://opensource.samsung.com/community/master/masterList의 sos-masters Toddler 과정을 참고 하셔도 좋습니다.)
• Star는 Githb에서 즐겨찾기의 기능을 하며, Fork는 해당 레포지토리의 마스터 브랜치를 그대로 따서 본인의 계정에 레포지토리를 생성하는 것입니다.
• $ git clone https://github.com/본인의_Github_ID/sos-practice.git 를 입력하여 소스를 다운로드 받으세요.
• VS Code, 혹은 기타 IDE/편집기로 코드를 수정, 혹은 생성하신 후,
• $ git add . -> $ git commit -s -> $ git push 를 통해 업로드해주세요.
• 마지막으로, 원본 레포지토리로 오셔서, Pull Requests 탭에서 PR을 올려주세요!
• 메인테이너가 해당 PR을 확인하고, 피드백을 주고, Merge를 진행합니다.

---

SOS-MASTERS 소통 :

SOS-MASTERS Facebook Group : Facebook Link

마스터즈 프로그램 홈페이지 가이드 참고

- 이런 분께 추천드려요!

• 아직 Git과 Github에 대해 잘 모르시는 분
• 아직 어떤 오픈소스에 컨트리뷰트하고 싶은지 모르겠는 분
• 선뜻 오픈소스 컨트리뷰트 시작하기가 두려우신 분
• Easy한 오픈소스 튜토리얼로 실력을 쌓고 싶은 분

- 튜토리얼은 주로 어떤 언어를 쓰나요?

• 현재는 Python3를 사용하고 있고, 최대한 쉬운 구성으로 가고 있습니다.
• Python3를 몰라도 참여할 수 있을 정도로 쉬운 오픈소스를 목표로 하고 있습니다. 실제로 Python3를 몰라도 번역 및 내용 추가 등의 기여를 할 수 있습니다.
• 그 외에도 Javascript 등의 언어를 통해 UI 기여를 할 수 있습니다.

- 이곳에서는 무엇을 기여하나요?

• 한국어 번역을 부탁드립니다.
• 자신이 아는 더 많은 Git 정보와 Opensource 정보를 나눠주세요.
• 더 많은 기능을 추가해주세요.
• 더 예쁜 UI를 입혀주세요.
• 함께 SOS-Practice에 기여하고 SOS-Practice의 메인테이너가 되어 주세요. :)

- 제가 얻어갈 수 있는 것에는 무엇이 있나요?

• 후기 sos-masters 들을 위한 튜토리얼 정보를 추가하여 미래를 위한 기록을 남길 수 있습니다.
• Git 커밋 룰 등의 기초적인, 그러나 반드시 필요한 정보를 얻고, 실전으로 적용해보실 수 있습니다. 추후 타 오픈소스로 진출하실 때에 당황하시지 않도록 도와드립니다.
• 해보고 싶은 모든 것을 해보실 수 있습니다. 만약 Python3 기반의 프로그램이 아닌, Flutter 등의 다양한 sos-practice 앱을 만들어보는 시도도 모두 OK.
• 실제 오픈소스 컨트리뷰션을 시작하기 전 준비와 테스트를 해볼 수 있습니다.