Ver3.5 ๐ ์คํ์์ค ๊ธฐ์ฌํ๊ธฐ: ํ์ด์ฌ ํ๋ก์ ํธ์ ์ฐธ์ฌํ๊ณ ์ค๋ ฅ์ ํค์ฐ๋ ํ์ค์ ์ธ ๋ฐฉ๋ฒ

๐ ์คํ์์ค ๊ธฐ์ฌํ๊ธฐ: ํ์ด์ฌ ํ๋ก์ ํธ์ ์ฐธ์ฌํ๊ณ ์ค๋ ฅ์ ํค์ฐ๋ ํ์ค์ ์ธ ๋ฐฉ๋ฒ
์ฒ์ PR ๋ ๋ฆฌ๋ ์๊ฐ๋ถํฐ, ๋ฉ์ธํ ์ด๋๊ฐ ๋๋ ๊ทธ๋ ๊น์ง ๐
์ผ, ์์งํ ๋งํด๋ณผ๊ฒ. ์คํ์์ค ๊ธฐ์ฌ๋ผ๋ ๋ง ๋ค์ผ๋ฉด ์ด๋ค ๋๋์ด์ผ? ๐ค
"๋ ๊ฐ์ ์ด๋ณด๊ฐ ๊ฐํ?"๋ผ๋ ์๊ฐ์ด ๋จผ์ ๋๋ ์ฌ๋, ์ ๋ค์ด๋ด.
์๋๋ฉด "์ธ์ ๊ฐ๋ ํด๋ด์ผ์ง..." ํ๋ฉด์ ๋ช ๋ฌ์งธ ๋ฏธ๋ฃจ๊ณ ์๋ ์ฌ๋๋ ์์ ๊ฑฐ์ผ.
๊ทผ๋ฐ ์์์, ์คํ์์ค ๊ธฐ์ฌ๋ ์๊ฐ๋ณด๋ค ํจ์ฌ ๊ฐ๊น์ด ์์ด.
์คํ ํ๋ ๊ณ ์น๋ ๊ฒ๋, ๋ฌธ์ ํ ์ค ๋ฒ์ญํ๋ ๊ฒ๋ ๋ค ๊ธฐ์ฌ์ผ.
๊ทธ๋ฆฌ๊ณ ํ์ด์ฌ ์ํ๊ณ๋ ํนํ ์
๋ฌธ์์๊ฒ ์น์ ํ ์ปค๋ฎค๋ํฐ๋ก ์ ๋ช
ํ๊ฑฐ๋ .
์ด ๊ธ์์๋ ํ์ด์ฌ ์คํ์์ค ํ๋ก์ ํธ์ ๊ธฐ์ฌํ๋ ๋ฐฉ๋ฒ์ ์ฒ์๋ถํฐ ๋๊น์ง, ์ง์ง ํ์ค์ ์ผ๋ก ํ์ด๋ณผ๊ฒ.
์ด๋ก ๋ง ๋์ด๋๋ ๊ธ ๋ง๊ณ , ์ค์ ๋ก ์จ๋จน์ ์ ์๋ ๋ด์ฉ์ผ๋ก! ๐ช
๐ฑ 1. ์คํ์์ค ๊ธฐ์ฌ, ์ ํ์ด์ฌ์ธ๊ฐ?
ํ์ด์ฌ์ ์ ์ธ๊ณ์์ ๊ฐ์ฅ ํ๋ฐํ ์คํ์์ค ์ํ๊ณ ์ค ํ๋์ผ.
GitHub์์ ํ์ด์ฌ ๊ด๋ จ ๋ ํฌ์งํ ๋ฆฌ ์๋ ์๋ฐฑ๋ง ๊ฐ์ ๋ฌํ๊ณ ,
NumPy, Pandas, Django, Flask, FastAPI, Requests, Scikit-learn ๊ฐ์ ์ด๋ํ ํ๋ก์ ํธ๋ค์ด ๋ชจ๋ ์คํ์์ค๋ก ์ด์๋๊ณ ์์ด.
ํ์ด์ฌ ์ปค๋ฎค๋ํฐ๊ฐ ํนํ ์
๋ฌธ์ ์นํ์ ์ธ ์ด์ ๊ฐ ๋ช ๊ฐ์ง ์์ด:
ํ์ด์ฌ ์ํํธ์จ์ด ์ฌ๋จ(PSF)์ ๊ณต์์ ์ธ ํ๋ ๊ฐ๋ น์ ์ด์ํด.
๋ชจ๋ ํ์ด์ฌ ๊ด๋ จ ์ปค๋ฎค๋ํฐ์์ ์กด์ค๊ณผ ํฌ์ฉ์ ๊ฐ์กฐํ๊ธฐ ๋๋ฌธ์
์ด๋ณด์๋ ์ง๋ฌธํ๊ธฐ ํธํ ๋ถ์๊ธฐ์ผ.
2. ํ๋ถํ ๋ฌธ์ํ ๋ฌธํ
ํ์ด์ฌ ํ๋ก์ ํธ๋ค์ ๋์ฒด๋ก CONTRIBUTING.md, README, ์ํค ๋ฑ์ด ์ ์ ๋น๋์ด ์์ด.
์ด๋ป๊ฒ ๊ธฐ์ฌํด์ผ ํ๋์ง ๊ฐ์ด๋๋ผ์ธ์ด ๋ช ํํ๊ฒ ๋์ ์๋ ๊ฒฝ์ฐ๊ฐ ๋ง์.
3. ๋ค์ํ ๊ธฐ์ฌ ์ ํ
์ฝ๋๋ง์ด ๊ธฐ์ฌ๊ฐ ์๋์ผ. ๋ฌธ์ ๋ฒ์ญ, ๋ฒ๊ทธ ๋ฆฌํฌํธ, ํ ์คํธ ์์ฑ, ์์ ์ฝ๋ ์ถ๊ฐ ๋ฑ
๋ค์ํ ๋ฐฉ์์ผ๋ก ์ฐธ์ฌํ ์ ์์ด.
4. ํ๋ฐํ ๋ฉํ ๋ง ํ๋ก๊ทธ๋จ
Google Summer of Code(GSoC), Outreachy ๊ฐ์ ๊ณต์ ๋ฉํ ๋ง ํ๋ก๊ทธ๋จ์
ํ์ด์ฌ ํ๋ก์ ํธ๋ค์ด ๋งค๋ ์ฐธ์ฌํด. ์ฒด๊ณ์ ์ผ๋ก ๋ฐฐ์ธ ์ ์๋ ๊ธฐํ๊ฐ ์์ด.
๊ทธ๋ฆฌ๊ณ ์์งํ ๋งํ๋ฉด, ์คํ์์ค ๊ธฐ์ฌ๋ ์ทจ์
์ค๋น์๋ ์์ฒญ๋ ๋์์ด ๋ผ.
์ค์ ๋ก ๋ง์ ํ
ํฌ ๊ธฐ์
๋ค์ด GitHub ํ๋กํ์ ํฌํธํด๋ฆฌ์ค๋ก ๋ณด๊ฑฐ๋ .
์ ๋ช
ํ๋ก์ ํธ์ ๊ธฐ์ฌ ์ด๋ ฅ์ด ์์ผ๋ฉด ๋ฉด์ ์์ ํ์คํ ๋์ ๋์ด.
์ฌ๋ฅ๋ท ๊ฐ์ ํ๋ซํผ์์ ํ์ด์ฌ ๊ด๋ จ ์ฌ๋ฅ์ ๊ฑฐ๋ํ๋ ๋ถ๋ค๋ ๋ง์๋ฐ,
์คํ์์ค ๊ธฐ์ฌ ๊ฒฝํ์ ์์ ์ ์ค๋ ฅ์ ๊ฐ๊ด์ ์ผ๋ก ์ฆ๋ช
ํ๋ ์ต๊ณ ์ ๋ฐฉ๋ฒ ์ค ํ๋์ผ. ๐ผ
CPython ๋ ํฌ์งํ ๋ฆฌ์ Doc ํด๋์์ ๋ฌธ์ ์ค๋ฅ๋ฅผ ๋ฐ๊ฒฌํ๋ฉด ๋ฐ๋ก PR์ ๋ ๋ฆด ์ ์์ด.
ํ์ด์ฌ ๊ณต์ ๋ฌธ์์ ๊ธฐ์ฌํ ์ด๋ ฅ์ ์ ๋ง ๋ฉ์ง ํฌํธํด๋ฆฌ์ค๊ฐ ๋ผ.
๐ 2. ๋์๊ฒ ๋ง๋ ํ๋ก์ ํธ ์ฐพ๊ธฐ
์คํ์์ค ๊ธฐ์ฌ์ ์ฒซ ๋ฒ์งธ ๊ด๋ฌธ์ "์ด๋ค ํ๋ก์ ํธ์ ๊ธฐ์ฌํ ๊น?"์ผ.
๋ฌด์์ ์ ๋ช
ํ ํ๋ก์ ํธ์ ๋ฐ์ด๋ค๋ฉด ์คํ๋ ค ์ข์ ํ๊ธฐ ์ฌ์.
์์ ์๊ฒ ๋ง๋ ํ๋ก์ ํธ๋ฅผ ์ฐพ๋ ๊ฒ ์ค์ํด. ๐ฏ
ํ๋ก์ ํธ ์ ํ ๊ธฐ์ค
์ง์ ์จ๋ณธ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ ์ด๋ค ๋ถ๋ถ์ด ๋ถํธํ์ง, ์ด๋ค ๊ธฐ๋ฅ์ด ํ์ํ์ง ์๊ณ ์์ด.
์ด๋ฐ ๊ฒฝํ์ด ๊ธฐ์ฌ์ ์ถ๋ฐ์ ์ด ๋ผ.
โก ํ๋ฐํ๊ฒ ์ ์ง๋ณด์๋๋ ํ๋ก์ ํธ
๋ง์ง๋ง ์ปค๋ฐ์ด 2๋ ์ ์ธ ํ๋ก์ ํธ์ PR์ ๋ ๋ ค๋ดค์ ์๋ฌด๋ ์ ๋ด.
์ต๊ทผ 3~6๊ฐ์ ๋ด์ ์ปค๋ฐ์ด ์๋์ง ํ์ธํด.
โข ์ด์ ํธ๋์ปค๊ฐ ํ์ฑํ๋ ํ๋ก์ ํธ
GitHub Issues์ ์ต๊ทผ ์ด์๋ค์ด ์ฌ๋ผ์ค๊ณ , ๋ฉ์ธํ ์ด๋๊ฐ ๋ฐ์ํ๋์ง ๋ด.
์๋ต ์๋ ์ด์๋ค๋ง ์์ฌ ์์ผ๋ฉด ๊ธฐ์ฌํด๋ ๋ฌปํ ๊ฐ๋ฅ์ฑ์ด ๋์.
โฃ CONTRIBUTING.md๊ฐ ์๋ ํ๋ก์ ํธ
๊ธฐ์ฌ ๊ฐ์ด๋๋ผ์ธ์ด ๋ฌธ์ํ๋์ด ์๋ค๋ ๊ฑด ๊ธฐ์ฌ์๋ฅผ ํ์ํ๋ค๋ ์ ํธ์ผ.
โค good first issue ๋ผ๋ฒจ์ด ์๋ ํ๋ก์ ํธ
์ด๋ณด์๋ฅผ ์ํ ์ด์๋ฅผ ๋ณ๋๋ก ๋ถ๋ฅํด๋๋ ํ๋ก์ ํธ๋ ์ ๋ฌธ์์๊ฒ ์ต๊ณ ์ผ.
ํ๋ก์ ํธ ํ์ ๋๊ตฌ๋ค
์ข์ ํ๋ก์ ํธ๋ฅผ ์ฐพ๋ ๋ฐ ๋์์ด ๋๋ ์ฌ์ดํธ๋ค์ ์๊ฐํ ๊ฒ:
| ์ฌ์ดํธ | ํน์ง |
|---|---|
| GitHub Explore | ํธ๋ ๋ฉ ํ์ด์ฌ ๋ ํฌ์งํ ๋ฆฌ ํ์ ๊ฐ๋ฅ |
| goodfirstissue.dev | good first issue ๋ผ๋ฒจ ์ด์๋ง ๋ชจ์์ ๋ณด์ฌ์ค |
| up-for-grabs.net | ๊ธฐ์ฌ์๋ฅผ ์ฐพ๋ ํ๋ก์ ํธ ๋ชฉ๋ก |
| CodeTriage | ์ด๋ฉ์ผ๋ก ๋งค์ผ ์คํ ์ด์ ์๋ฆผ ๋ฐ๊ธฐ |
| firstcontributions.github.io | ์ฒซ ๊ธฐ์ฌ ์ฐ์ต์ฉ ํ๋ก์ ํธ |
| PyPI ๊ณต์ ์ฌ์ดํธ | ์์ฃผ ์ฐ๋ ํจํค์ง์ GitHub ๋งํฌ ํ์ธ |
์ ๋ฌธ์์๊ฒ ์ถ์ฒํ๋ ํ์ด์ฌ ํ๋ก์ ํธ๋ค
โข Rich - ํฐ๋ฏธ๋ ์ถ๋ ฅ ๋ผ์ด๋ธ๋ฌ๋ฆฌ. ํ๋ฐํ ์ปค๋ฎค๋ํฐ์ ์น์ ํ ๋ฉ์ธํ ์ด๋.
โข Click - CLI ๋๊ตฌ ์ ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ. ์ด์ ํธ๋์ปค๊ฐ ์ ๊ด๋ฆฌ๋จ.
โข Pillow - ์ด๋ฏธ์ง ์ฒ๋ฆฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ. ๋ค์ํ ๋์ด๋์ ์ด์ ์กด์ฌ.
โข Python-dateutil - ๋ ์ง ์ฒ๋ฆฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ. ๋น๊ต์ ์์ ์ฝ๋๋ฒ ์ด์ค.
๐ ๋ฌธ์ ๊ธฐ์ฌ์ ์ข์ ํ๋ก์ ํธ
โข CPython - ํ์ด์ฌ ๊ณต์ ๋ฌธ์ ๊ฐ์
โข Django - ๋ฐฉ๋ํ ๋ฌธ์, ๋ฒ์ญ ๊ธฐ์ฌ ๊ฐ๋ฅ
โข Pandas - ์์ ์ฝ๋ ์ถ๊ฐ, ์ค๋ช ๊ฐ์
ํ์ด์ฌ ํ๋ก์ ํธ์ ์ด๋ณด์์ฉ ์ด์๋ฅผ ํ ๋ฒ์ ์ฐพ์ ์ ์์ด!
โ๏ธ 3. ๊ฐ๋ฐ ํ๊ฒฝ ์ธํ : ๊ธฐ์ฌ ์ ํ์ ์ค๋น
ํ๋ก์ ํธ๋ฅผ ๊ณจ๋์ผ๋ฉด ์ด์ ๊ฐ๋ฐ ํ๊ฒฝ์ ์ธํ
ํ ์ฐจ๋ก์ผ.
์ด ๋จ๊ณ๋ฅผ ์ ๋๋ก ์ ํ๋ฉด ๋์ค์ ์์ฒญ ๊ณ ์ํด. ์ฒ์์ ๊ผผ๊ผผํ๊ฒ ํ์! ๐ ๏ธ
Git ๊ธฐ๋ณธ ์ค์
์คํ์์ค ๊ธฐ์ฌ์ ํต์ฌ ๋๊ตฌ๋ Git์ด์ผ. ๊ธฐ๋ณธ ์ค์ ๋ถํฐ ํ์ธํด:
# Git ์ฌ์ฉ์ ์ ๋ณด ์ค์ (์ฒ์ ํ ๋ฒ๋ง)
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
# ํ์ฌ ์ค์ ํ์ธ
git config --list
Fork โ Clone โ Remote ์ค์
์คํ์์ค ๊ธฐ์ฌ์ ํ์ค ์ํฌํ๋ก์ฐ์ผ. ์์๋๋ก ๋ฐ๋ผํด๋ด:
๊ธฐ์ฌํ๊ณ ์ถ์ ๋ ํฌ์งํ ๋ฆฌ ํ์ด์ง์์ ์ฐ์ธก ์๋จ Fork ๋ฒํผ ํด๋ฆญ.
๋ด GitHub ๊ณ์ ์ ๋ณต์ฌ๋ณธ์ด ์๊ฒจ.
# ๋ด Fork๋ฅผ ๋ก์ปฌ์ ํด๋ก
git clone https://github.com/๋ด๊ณ์ /ํ๋ก์ ํธ๋ช
.git
cd ํ๋ก์ ํธ๋ช
# ์๋ณธ ๋ ํฌ๋ฅผ upstream์ผ๋ก ์ถ๊ฐ
git remote add upstream https://github.com/์๋ณธ๊ณ์ /ํ๋ก์ ํธ๋ช
.git
# ์ฐ๊ฒฐ ํ์ธ
git remote -v
# origin https://github.com/๋ด๊ณ์ /ํ๋ก์ ํธ๋ช
.git (fetch)
# origin https://github.com/๋ด๊ณ์ /ํ๋ก์ ํธ๋ช
.git (push)
# upstream https://github.com/์๋ณธ๊ณ์ /ํ๋ก์ ํธ๋ช
.git (fetch)
# upstream https://github.com/์๋ณธ๊ณ์ /ํ๋ก์ ํธ๋ช
.git (push)
# ๊ฐ์ํ๊ฒฝ ์์ฑ (ํ์ด์ฌ 3.x)
python -m venv venv
# ํ์ฑํ (macOS/Linux)
source venv/bin/activate
# ํ์ฑํ (Windows)
venv\Scripts\activate
# ๊ฐ๋ฐ ์์กด์ฑ ์ค์น (๋๋ถ๋ถ์ ํ๋ก์ ํธ)
pip install -e ".[dev]"
# ๋๋
pip install -r requirements-dev.txt
๋ฐ๋์ ๊ฐ์ํ๊ฒฝ(venv, conda, poetry ๋ฑ)์ ์ฌ์ฉํด์ผ ํด.
ํ๋ก์ ํธ๋ง๋ค ์์กด์ฑ ๋ฒ์ ์ด ๋ค๋ฅผ ์ ์๊ฑฐ๋ .
ํ๋ก์ ํธ๋ณ ๊ฐ๋ฐ ํ๊ฒฝ ์ธํ ๋ฐฉ๋ฒ
๋๋ถ๋ถ์ ํ์ด์ฌ ํ๋ก์ ํธ๋ ๋ค์ ์ค ํ๋์ ๋ฐฉ์์ ์ฌ์ฉํด:
| ๋๊ตฌ | ์ค์น ๋ช ๋ น์ด | ํน์ง |
|---|---|---|
| pip + venv | pip install -e .[dev] | ๊ฐ์ฅ ๊ธฐ๋ณธ์ ์ธ ๋ฐฉ์ |
| Poetry | poetry install | ์์กด์ฑ ๊ด๋ฆฌ๊ฐ ํธ๋ฆฌํจ |
| Hatch | hatch env create | ์ต์ ํ์ด์ฌ ํ๋ก์ ํธ์์ ๋ง์ด ์ฌ์ฉ |
| Conda | conda env create -f environment.yml | ๊ณผํ ๊ณ์ฐ ํ๋ก์ ํธ์์ ๋ง์ด ์ฌ์ฉ |
| tox | tox | ์ฌ๋ฌ ํ์ด์ฌ ๋ฒ์ ํ ์คํธ |
์์ค ์ฝ๋๋ฅผ ์์ ํ๋ฉด ์ฆ์ ๋ฐ์๋๊ธฐ ๋๋ฌธ์ ๊ฐ๋ฐํ ๋ ํ์์ผ.
๋งค๋ฒ ์ฌ์ค์นํ ํ์๊ฐ ์์ด์ ์์ฒญ ํธํด!
๐ 4. ์ด์ ํ์ ํ๊ธฐ: ๋ฌด์์ ๊ณ ์น ๊น?
ํ๊ฒฝ ์ธํ
์ด ๋๋ฌ์ผ๋ฉด ์ด์ ์ค์ ๋ก ๋ญ ํ ์ง ์ ํด์ผ ํด.
์ด์ ํธ๋์ปค๋ฅผ ์ฝ๋ ๊ฒ๋ ํ๋์ ๊ธฐ์ ์ด์ผ. ์ ์ฝ๋ ๋ฒ์ ์์๋ณด์! ๐
์ด์ ๋ผ๋ฒจ ์ดํดํ๊ธฐ
GitHub ์ด์์๋ ๋ค์ํ ๋ผ๋ฒจ์ด ๋ถ์ด ์์ด. ์ฃผ์ ๋ผ๋ฒจ๋ค์ ์์๋๋ฉด ๋์์ด ๋ผ:
| ๋ผ๋ฒจ | ์๋ฏธ | ์ถ์ฒ ๋์ |
|---|---|---|
| good first issue | ์ ๋ฌธ์์๊ฒ ์ ํฉํ ์ด์ | โญ ์ด๋ณด์ ๊ฐ๋ ฅ ์ถ์ฒ |
| help wanted | ๋์์ด ํ์ํ ์ด์ | ์ค๊ธ์ ์ถ์ฒ |
| bug | ๋ฒ๊ทธ ์์ ํ์ | ์ฝ๋ ์ดํด ํ ๋์ |
| documentation | ๋ฌธ์ ๊ด๋ จ ์ด์ | โญ ์ด๋ณด์ ์ถ์ฒ |
| enhancement | ๊ธฐ๋ฅ ๊ฐ์ ์์ฒญ | ์ค~๊ณ ๊ธ์ |
| duplicate | ์ค๋ณต ์ด์ | ๊ฑด๋๋ฆฌ์ง ๋ง |
| wontfix | ์์ ์ ํ ์ด์ | ๊ฑด๋๋ฆฌ์ง ๋ง |
์ด์ ์ ํ ์ ์ฒดํฌ๋ฆฌ์คํธ
์ด์ ๋๊ธ์ "I'll work on this" ๊ฐ์ ๋ง์ด ์์ผ๋ฉด ์ด๋ฏธ ๋๊ตฐ๊ฐ ์์ ์ค์ผ ์ ์์ด.
์ค๋ณต ์์ ์ ํผํ๊ธฐ ์ํด ๋จผ์ ํ์ธํด.
โก ์ฐ๊ฒฐ๋ PR์ด ์๋๊ฐ?
์ด์ ํ์ด์ง์ ์ฐ๊ฒฐ๋ PR์ด ์์ผ๋ฉด ์ด๋ฏธ ๋๊ตฐ๊ฐ ํด๊ฒฐ ์ค์ธ ๊ฑฐ์ผ.
โก ์ด์๊ฐ ๋ช ํํ๊ฒ ์ ์๋์ด ์๋๊ฐ?
๋ญ ํด์ผ ํ๋์ง ๋ชจํธํ ์ด์๋ ์ด๋ณด์์๊ฒ ์ด๋ ค์.
๋ช ํํ๊ฒ "์ด ํ์ผ์ ์ด ๋ถ๋ถ์ ์์ ํด๋ผ"๋ ์์ ์ด์๊ฐ ์ข์.
โก ๋ด ์ค๋ ฅ ์์ค์ ๋ง๋๊ฐ?
์์ฌ๋ด์ง ๋ง๊ณ ๋ด ์์ค์ ๋ง๋ ์ด์๋ถํฐ ์์ํด.
์์ ์ฑ๊ณต ๊ฒฝํ์ด ์์ฌ์ผ ๋ ํฐ ๊ธฐ์ฌ๋ฅผ ํ ์ ์์ด.
์ด์์ ๋๊ธ ๋ฌ๊ธฐ: ์์ ์์ฌ ํ๋ช
์ด์๋ฅผ ๊ณจ๋์ผ๋ฉด ๋ฐ๋ก ์ฝ๋ ์ง๋ฌ ๊ฐ์ง ๋ง๊ณ , ๋จผ์ ๋๊ธ์ ๋ฌ์์ผ ํด!
์ด๊ฒ ์คํ์์ค ์ํฐ์ผ์ด์ผ. ์ด๋ฐ ์์ผ๋ก ์จ๋ด:
๋๋ ๋ ๊ฐ๋จํ๊ฒ:
"I'd like to take a look at this. Is it still available?"
์ ๋๊ธ์ ๋จผ์ ๋ฌ์์ผ ํ๋๊ณ ?
โ ์ค๋ณต ์์ ๋ฐฉ์ง
โก ๋ฉ์ธํ ์ด๋์๊ฒ ์ ๊ทผ ๋ฐฉ๋ฒ ํผ๋๋ฐฑ ๋ฐ์ ์ ์์
โข ์ด์๊ฐ ์ค์ ๋ก ์ ํจํ์ง ํ์ธ ๊ฐ๋ฅ
โฃ ์ปค๋ฎค๋ํฐ์ ์ํตํ๋ ์ข์ ์์์
๊ทธ๋ฅ ์์ ์ ์์ํด๋ ๊ด์ฐฎ์. ๋จ, PR ์ค๋ช ์ ์ด๋ค ์ด์๋ฅผ ํด๊ฒฐํ๋์ง ๋ช ์ํด์ค.
Fixes #์ด์๋ฒํธ ๋ฅผ PR ๋ณธ๋ฌธ์ ๋ฃ์ผ๋ฉด ์๋์ผ๋ก ์ฐ๊ฒฐ๋ผ.
โ๏ธ 5. ์ค์ ์ฝ๋ ์์ฑ: ๋ธ๋์น๋ถํฐ ์ปค๋ฐ๊น์ง
๋๋์ด ์ฝ๋๋ฅผ ์งค ์๊ฐ์ด์ผ! ๐
ํ์ง๋ง ์ฝ๋๋ฅผ ์ง๊ธฐ ์ ์ ๋ช ๊ฐ์ง ์ค์ํ ๊ท์น๋ค์ ์์์ผ ํด.
๋ธ๋์น ๋ค์ด๋ฐ ์ปจ๋ฒค์
๋ธ๋์น ์ด๋ฆ์ ์์ ๋ด์ฉ์ ๋ช ํํ๊ฒ ๋ํ๋ด์ผ ํด:
# ๋ฒ๊ทธ ์์
git checkout -b fix/issue-123-null-pointer-error
# ์ ๊ธฐ๋ฅ ์ถ๊ฐ
git checkout -b feature/add-timeout-parameter
# ๋ฌธ์ ์์
git checkout -b docs/update-installation-guide
# ํ
์คํธ ์ถ๊ฐ
git checkout -b test/add-edge-case-tests
# ๋ฆฌํฉํ ๋ง
git checkout -b refactor/simplify-parser-logic
์ปค๋ฐ ๋ฉ์์ง ์์ฑ๋ฒ
์ปค๋ฐ ๋ฉ์์ง๋ ์คํ์์ค์์ ์ ๋ง ์ค์ํด.
๋๋ถ๋ถ์ ํ๋ก์ ํธ๋ Conventional Commits ํ์์ ๋ฐ๋ฅด๊ฑฐ๋
์์ฒด์ ์ธ ์ปค๋ฐ ๋ฉ์์ง ๊ท์น์ด ์์ด. CONTRIBUTING.md๋ฅผ ๊ผญ ํ์ธํด!
ํ์ (๋ฒ์): ๊ฐ๊ฒฐํ ์ค๋ช
ํ์ ์ข ๋ฅ:
โข fix: ๋ฒ๊ทธ ์์
โข feat: ์ ๊ธฐ๋ฅ ์ถ๊ฐ
โข docs: ๋ฌธ์ ๋ณ๊ฒฝ
โข test: ํ ์คํธ ์ถ๊ฐ/์์
โข refactor: ์ฝ๋ ๋ฆฌํฉํ ๋ง
โข style: ์ฝ๋ ์คํ์ผ ๋ณ๊ฒฝ (๊ธฐ๋ฅ ๋ณ๊ฒฝ ์์)
โข chore: ๋น๋ ํ๋ก์ธ์ค, ๋๊ตฌ ๋ณ๊ฒฝ
์์:
fix(parser): handle empty string input correctly
feat(api): add timeout parameter to request method
docs(readme): update installation instructions for Windows
# ๋์ ์ปค๋ฐ ๋ฉ์์ง โ
git commit -m "fix bug"
git commit -m "update"
git commit -m "asdfgh"
# ์ข์ ์ปค๋ฐ ๋ฉ์์ง โ
git commit -m "fix(auth): resolve token expiration not being checked"
git commit -m "docs: add example for custom middleware usage"
git commit -m "test: add unit tests for edge cases in parser module"
์ฝ๋ ์คํ์ผ ๋ง์ถ๊ธฐ
ํ์ด์ฌ ํ๋ก์ ํธ๋ค์ ๋๋ถ๋ถ ์ฝ๋ ์คํ์ผ ๋๊ตฌ๋ฅผ ์ฌ์ฉํด.
PR์ ๋ ๋ฆฌ๊ธฐ ์ ์ ๋ฐ๋์ ์คํ์ผ ์ฒดํฌ๋ฅผ ํต๊ณผํด์ผ ํด!
| ๋๊ตฌ | ์ญํ | ์คํ ๋ช ๋ น์ด |
|---|---|---|
| Black | ์ฝ๋ ์๋ ํฌ๋งทํ | black . |
| isort | import ์ ๋ ฌ | isort . |
| flake8 | ์ฝ๋ ์คํ์ผ ๊ฒ์ฌ | flake8 . |
| mypy | ํ์ ์ฒดํฌ | mypy . |
| ruff | ๋น ๋ฅธ ๋ฆฐํฐ (์ต์ ํธ๋ ๋) | ruff check . |
| pre-commit | ์ปค๋ฐ ์ ์๋ ๊ฒ์ฌ | pre-commit install |
pre-commit install ์ ์คํํด๋ด.
๊ทธ๋ฌ๋ฉด ์ปค๋ฐํ ๋๋ง๋ค ์๋์ผ๋ก ์คํ์ผ ์ฒดํฌ๊ฐ ๋ผ์ ์ค์๋ฅผ ์ค์ผ ์ ์์ด!
์ค์ ์ฝ๋ ์์ ์์
๊ฐ๋จํ ๋ฒ๊ทธ ์์ ์์๋ฅผ ๋ณด์ฌ์ค๊ฒ. Requests ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์คํ์ผ๋ก ๊ฐ์ ํด๋ณผ๊ฒ:
# ์์ ์ (๋ฒ๊ทธ ์์)
def parse_timeout(timeout):
"""Parse timeout value."""
if timeout is None:
return None
return int(timeout) # ์์์ ํ์์์์ ์ฒ๋ฆฌ ๋ชปํจ
# ์์ ํ (๋ฒ๊ทธ ์์ )
def parse_timeout(timeout):
"""Parse timeout value.
Args:
timeout: Timeout in seconds. Can be int or float.
Returns:
Parsed timeout value or None.
Raises:
ValueError: If timeout is negative.
"""
if timeout is None:
return None
timeout = float(timeout) # int์ float ๋ชจ๋ ์ฒ๋ฆฌ
if timeout < 0:
raise ValueError(f"Timeout must be non-negative, got {timeout}")
return timeout
๋ด ์ทจํฅ๋๋ก ๋ฆฌํฉํ ๋งํ๊ฑฐ๋ ๋ถํ์ํ ๋ณ๊ฒฝ์ ์ถ๊ฐํ๋ฉด PR์ด ๊ฑฐ์ ๋ ์ ์์ด.
์ต์ํ์ ๋ณ๊ฒฝ์ผ๋ก ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ ๊ฒ์ด ์คํ์์ค ๊ธฐ์ฌ์ ๊ธฐ๋ณธ์ด์ผ.
๐งช 6. ํ ์คํธ ์์ฑ: ๊ธฐ์ฌ์ ์์ฑ๋๋ฅผ ๋์ด๋ ํต์ฌ
์ฝ๋๋ฅผ ์์ ํ์ผ๋ฉด ํ
์คํธ๋ ํจ๊ป ์์ฑํด์ผ ํด.
ํ
์คํธ ์๋ PR์ ๋๋ถ๋ถ์ ํ๋ก์ ํธ์์ ๊ฑฐ์ ๋นํด.
ํ
์คํธ๋ ๊ท์ฐฎ์ ๊ฒ ์๋๋ผ, ๋ด ์ฝ๋๊ฐ ์ ๋๋ก ๋์ํ๋ค๋ ์ฆ๋ช
์ด์ผ! ๐งช
pytest ๊ธฐ๋ณธ ์ฌ์ฉ๋ฒ
ํ์ด์ฌ ์คํ์์ค ํ๋ก์ ํธ์ 90% ์ด์์ pytest๋ฅผ ์ฌ์ฉํด:
# pytest ์ค์น
pip install pytest pytest-cov
# ํ
์คํธ ์คํ
pytest
# ํน์ ํ์ผ๋ง ํ
์คํธ
pytest tests/test_parser.py
# ํน์ ํ
์คํธ ํจ์๋ง ์คํ
pytest tests/test_parser.py::test_parse_timeout
# ์ปค๋ฒ๋ฆฌ์ง ๋ฆฌํฌํธ ํฌํจ
pytest --cov=mypackage --cov-report=term-missing
# ์์ธํ ์ถ๋ ฅ
pytest -v
# ์คํจํ ํ
์คํธ๋ง ์ฌ์คํ
pytest --lf
์ข์ ํ ์คํธ ์์ฑํ๊ธฐ
import pytest
from mypackage.utils import parse_timeout
class TestParseTimeout:
"""parse_timeout ํจ์ ํ
์คํธ"""
def test_none_returns_none(self):
"""None ์
๋ ฅ ์ None ๋ฐํ"""
assert parse_timeout(None) is None
def test_integer_input(self):
"""์ ์ ์
๋ ฅ ์ฒ๋ฆฌ"""
assert parse_timeout(30) == 30.0
def test_float_input(self):
"""์์์ ์
๋ ฅ ์ฒ๋ฆฌ (๋ฒ๊ทธ ์์ ๊ฒ์ฆ)"""
assert parse_timeout(0.5) == 0.5
assert parse_timeout(1.5) == 1.5
def test_string_number_input(self):
"""๋ฌธ์์ด ์ซ์ ์
๋ ฅ ์ฒ๋ฆฌ"""
assert parse_timeout("30") == 30.0
def test_negative_raises_error(self):
"""์์ ์
๋ ฅ ์ ValueError ๋ฐ์"""
with pytest.raises(ValueError, match="non-negative"):
parse_timeout(-1)
def test_zero_is_valid(self):
"""0์ ์ ํจํ ํ์์์"""
assert parse_timeout(0) == 0.0
@pytest.mark.parametrize("value,expected", [
(1, 1.0),
(2.5, 2.5),
(100, 100.0),
])
def test_various_valid_inputs(self, value, expected):
"""๋ค์ํ ์ ํจ ์
๋ ฅ๊ฐ ํ
์คํธ"""
assert parse_timeout(value) == expected
ํ ์คํธ ์ด๋ฆ๋ง ๋ด๋ ๋ฌด์์ ํ ์คํธํ๋์ง ์ ์ ์์ด์ผ ํด.
test_parse_timeout_with_float_returns_float ์ฒ๋ผ ๊ตฌ์ฒด์ ์ผ๋ก.
โก ํ๋์ ํ ์คํธ๋ ํ๋์ ๋์๋ง ๊ฒ์ฆ
์ฌ๋ฌ ๊ฐ์ง๋ฅผ ํ ํ ์คํธ์ ๋ฃ์ผ๋ฉด ์ด๋์ ์คํจํ๋์ง ํ์ ํ๊ธฐ ์ด๋ ค์.
โข ์ฃ์ง ์ผ์ด์ค ํฌํจ
None, ๋น ๋ฌธ์์ด, ์์, 0, ๋งค์ฐ ํฐ ๊ฐ ๋ฑ ๊ฒฝ๊ณ๊ฐ์ ํ ์คํธํด.
โฃ ๊ธฐ์กด ํ ์คํธ ์คํ์ผ ๋ฐ๋ฅด๊ธฐ
ํ๋ก์ ํธ์ ๊ธฐ์กด ํ ์คํธ ํ์ผ์ ๋ณด๊ณ ๊ฐ์ ์คํ์ผ๋ก ์์ฑํด.
CI/CD ํ์ดํ๋ผ์ธ ์ดํดํ๊ธฐ
PR์ ๋ ๋ฆฌ๋ฉด ์๋์ผ๋ก CI(Continuous Integration)๊ฐ ์คํ๋ผ.
GitHub Actions, Travis CI, CircleCI ๋ฑ์ด ์๋์ผ๋ก ํ
์คํธ๋ฅผ ๋๋ ค์ค.
CI๊ฐ ํต๊ณผ(์ด๋ก๋ถ)๋์ด์ผ PR์ด ๋จธ์ง๋ ๊ฐ๋ฅ์ฑ์ด ๋์์ ธ.
pytest ๊ฐ ํต๊ณผํ๋ฉด CI๋ ๋๋ถ๋ถ ํต๊ณผํด.
CI ์คํจ ํ ์์ ํ๋ ๊ฒ๋ณด๋ค ๋ฏธ๋ฆฌ ํ์ธํ๋ ๊ฒ ํจ์ฌ ํจ์จ์ ์ด์ผ!
๐ฌ 7. Pull Request ์์ฑ: ์ฒซ์ธ์์ด ์ ๋ถ๋ค
๋๋์ด PR์ ๋ ๋ฆด ์๊ฐ์ด์ผ! ๐
PR์ ๋จ์ํ ์ฝ๋๋ฅผ ์ฌ๋ฆฌ๋ ๊ฒ ์๋์ผ.
๋ฉ์ธํ
์ด๋์๊ฒ "๋ด๊ฐ ์ด๋ฐ ๋ฌธ์ ๋ฅผ ์ด๋ ๊ฒ ํด๊ฒฐํ์ด"๋ผ๊ณ ์ค๋ช
ํ๋ ๊ฑฐ์ผ.
์ข์ PR์ ๋ฆฌ๋ทฐ์ด์ ์๊ฐ์ ์๊ปด์ฃผ๊ณ , ๋น ๋ฅธ ๋จธ์ง๋ก ์ด์ด์ ธ.
PR ์ ์ถ ์ ์ต์ข ์ฒดํฌ๋ฆฌ์คํธ
โก ๋ชจ๋ ํ ์คํธ๊ฐ ํต๊ณผํ๋๊ฐ? (pytest)
โก ์ฝ๋ ์คํ์ผ ๊ฒ์ฌ๋ฅผ ํต๊ณผํ๋๊ฐ? (black, flake8 ๋ฑ)
โก ์๋ก์ด ๊ธฐ๋ฅ/๋ฒ๊ทธ ์์ ์ ๋ํ ํ ์คํธ๋ฅผ ์ถ๊ฐํ๋๊ฐ?
โก ํ์ํ ๊ฒฝ์ฐ ๋ฌธ์๋ฅผ ์ ๋ฐ์ดํธํ๋๊ฐ?
โก ์ปค๋ฐ ๋ฉ์์ง๊ฐ ํ๋ก์ ํธ ์ปจ๋ฒค์ ์ ๋ฐ๋ฅด๋๊ฐ?
โก ๋ถํ์ํ ํ์ผ(์บ์, .pyc, .DS_Store ๋ฑ)์ด ํฌํจ๋์ง ์์๋๊ฐ?
โก CHANGELOG๋ HISTORY ํ์ผ ์ ๋ฐ์ดํธ๊ฐ ํ์ํ๊ฐ?
upstream ๋๊ธฐํํ๊ธฐ
# upstream์ ์ต์ ๋ณ๊ฒฝ์ฌํญ ๊ฐ์ ธ์ค๊ธฐ
git fetch upstream
# ๋ด ๋ธ๋์น๋ฅผ upstream/main ๊ธฐ์ค์ผ๋ก ๋ฆฌ๋ฒ ์ด์ค
git rebase upstream/main
# ์ถฉ๋์ด ์์ผ๋ฉด ํด๊ฒฐ ํ
git add .
git rebase --continue
# ๋ด Fork์ ๊ฐ์ ํธ์ (๋ฆฌ๋ฒ ์ด์ค ํ ํ์)
git push origin feature/my-fix --force-with-lease
์ข์ PR ์ค๋ช ์์ฑํ๊ธฐ
๋๋ถ๋ถ์ ํ๋ก์ ํธ๋ PR ํ ํ๋ฆฟ์ด ์์ด. ์์ผ๋ฉด ์ด ํ์์ ์ฐธ๊ณ ํด:
์ด PR์ `parse_timeout` ํจ์๊ฐ ์์์ ํ์์์ ๊ฐ์ ์ฒ๋ฆฌํ์ง ๋ชปํ๋ ๋ฒ๊ทธ๋ฅผ ์์ ํฉ๋๋ค.
## ๊ด๋ จ ์ด์ (Related Issue)
Fixes #123
## ๋ณ๊ฒฝ ๋ด์ฉ (Changes)
- `int(timeout)` ์ `float(timeout)` ์ผ๋ก ๋ณ๊ฒฝ
- ์์ ์ ๋ ฅ์ ๋ํ `ValueError` ์ถ๊ฐ
- ๊ด๋ จ ํ ์คํธ ์ผ์ด์ค ์ถ๊ฐ
## ํ ์คํธ ๋ฐฉ๋ฒ (How to Test)
```python
from mypackage.utils import parse_timeout
parse_timeout(0.5) # ์ด์ : TypeError, ์ดํ: 0.5
```
## ์คํฌ๋ฆฐ์ท (Screenshots, if applicable)
ํด๋น ์์
fix: handle float timeout values in parse_timeout ์ฒ๋ผ.
"Fix bug" ๊ฐ์ ๋ชจํธํ ์ ๋ชฉ์ ๋ฆฌ๋ทฐ์ด๊ฐ ๋ญ ๋ด์ผ ํ๋์ง ๋ชจ๋ฅด๊ฒ ํด.
๐ฌ 8. ์ฝ๋ ๋ฆฌ๋ทฐ ๋์: ์คํ์์ค์ ๊ฝ
PR์ ๋ ๋ ธ์ผ๋ฉด ์ด์ ๊ธฐ๋ค๋ฆฌ๋ ์๊ฐ์ด์ผ.
๋ฉ์ธํ
์ด๋๋ ๋ค๋ฅธ ์ปจํธ๋ฆฌ๋ทฐํฐ๊ฐ ์ฝ๋๋ฅผ ๋ฆฌ๋ทฐํ๊ณ ํผ๋๋ฐฑ์ ์ค ๊ฑฐ์ผ.
์ด ๊ณผ์ ์ด ์คํ์์ค ๊ธฐ์ฌ์์ ๊ฐ์ฅ ๋ฐฐ์ธ ๊ฒ ๋ง์ ์๊ฐ์ด์ผ! ๐
๋ฆฌ๋ทฐ ํผ๋๋ฐฑ ์ ํ
| ํผ๋๋ฐฑ ์ ํ | ์๋ฏธ | ๋์ ๋ฐฉ๋ฒ |
|---|---|---|
| Changes requested | ์์ ์ด ํ์ํจ | ํผ๋๋ฐฑ ๋ฐ์ ํ ์ฌ์ ์ถ |
| Approved | ์น์ธ! ๋จธ์ง ๊ฐ๋ฅ | ๐ ๊ธฐ๋ค๋ฆฌ๋ฉด ๋จธ์ง๋จ |
| Comment | ์๊ฒฌ/์ง๋ฌธ (์น์ธ/๊ฑฐ์ ์๋) | ๋ต๋ณ ๋๋ ๋ฐ์ |
| Nit: | ์ฌ์ํ ์คํ์ผ ์ง์ | ๋ฐ์ํ๊ฑฐ๋ ์ด์ ์ค๋ช |
| LGTM | Looks Good To Me (๋น๊ณต์ ์น์ธ) | ์ข์ ์ ํธ! |
๋ฆฌ๋ทฐ ํผ๋๋ฐฑ ๋์ ์ํฐ์ผ
"Thank you for the review!" ํ ๋ง๋๊ฐ ๊ด๊ณ๋ฅผ ์ข๊ฒ ๋ง๋ค์ด.
โก ํผ๋๋ฐฑ์ ์ดํดํ๋ค๋ ์ ํธ ๋ณด๋ด๊ธฐ
๊ฐ ์ฝ๋ฉํธ์ "Fixed!" ๋๋ "Done!" ์ผ๋ก ๋ฐ์ํด์ค.
๋ฆฌ๋ทฐ์ด๊ฐ ์ด๋ค ํผ๋๋ฐฑ์ด ๋ฐ์๋๋์ง ์ถ์ ํ๊ธฐ ์ฌ์์ ธ.
โข ๋์ํ์ง ์์ ๋๋ ์ ์คํ๊ฒ ์ด์ ์ค๋ช
"I understand your concern, but I think [์ด์ ] because [๊ทผ๊ฑฐ]"
๋ฌด์กฐ๊ฑด ๋ฐ๋ฅด๋ ๊ฒ ์๋๋ผ ๋ ผ๋ฆฌ์ ์ผ๋ก ํ ๋ก ํ๋ ๊ฒ๋ OK์ผ.
โฃ ์์ ํ ๋ฆฌ๋ทฐ์ด์๊ฒ ์๋ฆฌ๊ธฐ
"I've addressed all the comments. Could you take another look?" ์ฒ๋ผ
์์ ์ด ์๋ฃ๋์์ ์๋ ค์ค. ์ ๊ทธ๋ฌ๋ฉด ๋ฆฌ๋ทฐ์ด๊ฐ ๋ชจ๋ฅผ ์ ์์ด.
โข ํผ๋๋ฐฑ์ ๊ฐ์ ์ ์ผ๋ก ๋ฐ์ํ๊ธฐ
โข ๋ฉฐ์น ์ด ์ง๋๋ ์์ ์ ํ๊ณ ๋ฐฉ์นํ๊ธฐ
โข ๋ฆฌ๋ทฐ์ด๋ฅผ ์ฌ์ดํ๊ฑฐ๋ ์๋ฐํ๊ธฐ
โข ํผ๋๋ฐฑ ์์ด PR์ ๋ซ๊ณ ์ PR ์ด๊ธฐ
์์ ํ ์ฌ์ ์ถํ๊ธฐ
# ํผ๋๋ฐฑ ๋ฐ์ ํ ์ถ๊ฐ ์ปค๋ฐ
git add .
git commit -m "fix: address review comments"
# ๋๋ ๊ธฐ์กด ์ปค๋ฐ์ ํฉ์น๊ธฐ (squash)
git add .
git commit --amend --no-edit
# Fork์ ํธ์ (PR์ด ์๋์ผ๋ก ์
๋ฐ์ดํธ๋จ)
git push origin feature/my-fix
# ๊ฐ์ ํธ์๊ฐ ํ์ํ ๊ฒฝ์ฐ (amend ํ)
git push origin feature/my-fix --force-with-lease
๊ฒฝํ ๋ง์ ๋ฉ์ธํ ์ด๋๋ค์ ์ฝ๋ ๋ฆฌ๋ทฐ๋ ์ต๊ณ ์ ๋ฌด๋ฃ ์ฝ๋ ๊ต์ก์ด์ผ.
ํผ๋๋ฐฑ ํ๋ํ๋๋ฅผ ์์คํ๊ฒ ์ฌ๊ธฐ๊ณ ์ ๊ทธ๋ฐ ์ง์ ์ ํ๋์ง ์ดํดํ๋ ค๊ณ ๋ ธ๋ ฅํด๋ด.
๐ 9. ์ฝ๋ ์ธ ๊ธฐ์ฌ: ๋ฌธ์, ๋ฒ์ญ, ์ด์ ํธ๋ฆฌ์์ง
์คํ์์ค ๊ธฐ์ฌ = ์ฝ๋ ๊ธฐ์ฌ๋ผ๊ณ ์๊ฐํ๋ ์ฌ๋์ด ๋ง์๋ฐ, ์ ํ ์๋์ผ!
์ฝ๋ ์ธ ๊ธฐ์ฌ๋ ํ๋ก์ ํธ์ ์์ฒญ๋ ๊ฐ์น๋ฅผ ๋ํด.
ํนํ ํ์ด์ฌ ์ํ๊ณ์์๋ ๋ค์ํ ๋น์ฝ๋ ๊ธฐ์ฌ ๋ฐฉ๋ฒ์ด ์์ด. ๐
๋ฌธ์ ๊ธฐ์ฌ
๊ฐ์ฅ ์ฌ์ด ๊ธฐ์ฌ์ผ. ๋ฌธ์๋ฅผ ์ฝ๋ค๊ฐ ์คํ๋ฅผ ๋ฐ๊ฒฌํ๋ฉด ๋ฐ๋ก PR!
GitHub ์น ์ธํฐํ์ด์ค์์ ํ์ผ์ ์ง์ ์์ ํ ์๋ ์์ด.
โก ์์ ์ฝ๋ ์ถ๊ฐ
"์ด ํจ์ ์ด๋ป๊ฒ ์ฐ๋ ๊ฑฐ์ผ?"๋ผ๋ ์ง๋ฌธ์ด ๋ง์ ๋ถ๋ถ์ ์์ ๋ฅผ ์ถ๊ฐํด.
์ค์ ์ฌ์ฉ ์ฌ๋ก๋ฅผ ๋ณด์ฌ์ฃผ๋ ์์ ๋ ์ ๋ง ๊ฐ์น ์์ด.
โข ์ค๋ช ๊ฐ์
์ดํดํ๊ธฐ ์ด๋ ค์ด ์ค๋ช ์ ๋ ๋ช ํํ๊ฒ ๋ค์ ์จ.
์ด๋ณด์ ์ ์ฅ์์ "์ด๊ฒ ๋ญ ๋ง์ด์ผ?"๋ผ๊ณ ๋๋ ๋ถ๋ถ์ ๊ฐ์ ํด๋ด.
โฃ ํํ ๋ฆฌ์ผ ์์ฑ
์ฒ์ ์ฌ์ฉํ๋ ์ฌ๋์ ์ํ ๋จ๊ณ๋ณ ๊ฐ์ด๋๋ฅผ ์์ฑํด.
โค API ๋ฌธ์ ๊ฐ์
ํจ์/ํด๋์ค์ docstring์ ๋ ์์ธํ๊ฒ ์์ฑํด.
๋ฒ์ญ ๊ธฐ์ฌ
ํ์ด์ฌ ๊ณต์ ๋ฌธ์๋ ์ฌ๋ฌ ์ธ์ด๋ก ๋ฒ์ญ๋๊ณ ์์ด.
ํ๊ตญ์ด ๋ฒ์ญ ํ๋ก์ ํธ๋ ์์ด: python-docs-ko
์์ด๊ฐ ์ฝํ ์ฌ๋๋ค์ ์ํด ๋ฌธ์๋ฅผ ๋ฒ์ญํ๋ ๊ฒ๋ ํ๋ฅญํ ๊ธฐ์ฌ์ผ!
# python-docs-ko ๊ธฐ์ฌ ๋ฐฉ๋ฒ
git clone https://github.com/python/python-docs-ko.git
cd python-docs-ko
# ๋ฒ์ญํ ํ์ผ ์ ํ ํ .po ํ์ผ ์์
# ์: library/os.po
# ๋ฒ์ญ ์ํ ํ์ธ
make progress
์ด์ ํธ๋ฆฌ์์ง (Issue Triage)
์ด์ ํธ๋ฆฌ์์ง๋ ์๋ก ์ฌ๋ผ์จ ์ด์๋ค์ ๋ถ๋ฅํ๊ณ ์ ๋ฆฌํ๋ ์์
์ด์ผ.
์ฝ๋ฉ ์ค๋ ฅ์ด ์์ด๋ ํ ์ ์๋ ์ค์ํ ๊ธฐ์ฌ์ผ!
์ ์ด์๊ฐ ์ด๋ฏธ ์กด์ฌํ๋ ์ด์์ ๊ฐ์ ๋ด์ฉ์ธ์ง ํ์ธํ๊ณ ๋งํฌ ์ฐ๊ฒฐ.
โก ์ฌํ ํ์ธ
๋ฒ๊ทธ ์ด์๋ฅผ ์ง์ ์ฌํํด๋ณด๊ณ ๊ฒฐ๊ณผ๋ฅผ ๋๊ธ๋ก ๋จ๊ธฐ๊ธฐ.
"I can reproduce this on Python 3.11, macOS 13.0"
โข ์ถ๊ฐ ์ ๋ณด ์์ฒญ
์ด์ ๋ด์ฉ์ด ๋ถ์ถฉ๋ถํ ๋ ์ฌํ ์ฝ๋, ํ๊ฒฝ ์ ๋ณด ๋ฑ์ ์์ฒญ.
โฃ ๋ผ๋ฒจ ์ ์
์ด์์ ์ ์ ํ ๋ผ๋ฒจ์ ์ ์ํ๋ ๋๊ธ ๋ฌ๊ธฐ.
์ปค๋ฎค๋ํฐ ๊ธฐ์ฌ
ํ์ด์ฌ ๊ด๋ จ ์ง๋ฌธ์ ๋ต๋ณํ๊ธฐ. ํ๊ทธ: python, requests, django ๋ฑ
โข ํฌ๋ผ/Discord ์ฐธ์ฌ
ํ๋ก์ ํธ์ ๊ณต์ Discord, Slack, ํฌ๋ผ์์ ์ง๋ฌธ์ ๋ต๋ณํ๊ธฐ
โข ๋ธ๋ก๊ทธ ํฌ์คํธ ์์ฑ
ํ๋ก์ ํธ ์ฌ์ฉ ๊ฒฝํ, ํํ ๋ฆฌ์ผ ์์ฑ ํ ๊ณต์
โข ์ปจํผ๋ฐ์ค ๋ฐํ
PyCon, ์ง์ญ ํ์ด์ฌ ๋ฐ์ ์์ ํ๋ก์ ํธ ์๊ฐ ๋ฐํ
๐ 10. ์ค์ ๊ธฐ์ฌ ์๋๋ฆฌ์ค: ์ฒ์๋ถํฐ ๋๊น์ง
์ด๋ก ์ ์ถฉ๋ถํ ๋ฐฐ์ ์ผ๋ ์ค์ ์๋๋ฆฌ์ค๋ก ์ ์ฒด ๊ณผ์ ์ ํ ๋ฒ ๋ฐ๋ผ๊ฐ๋ณด์!
๊ฐ์์ ํ๋ก์ ํธ "awesome-python-utils"์ ๊ธฐ์ฌํ๋ ์ํฉ์ ๊ฐ์ ํ ๊ฒ. ๐ฌ
์๋๋ฆฌ์ค: ๋ฒ๊ทธ ์์ ๊ธฐ์ฌ
GitHub์์ label:"good first issue" language:python ๊ฒ์ ์ค
"format_date() returns wrong format for dates before 1970" ์ด์ ๋ฐ๊ฒฌ!
๋๊ธ์ "I'd like to work on this issue!" ์์ฑ.
# Fork ํ Clone
git clone https://github.com/๋ด๊ณ์ /awesome-python-utils.git
cd awesome-python-utils
# upstream ์ฐ๊ฒฐ
git remote add upstream https://github.com/์๋ณธ/awesome-python-utils.git
# ๊ฐ์ํ๊ฒฝ ์ธํ
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"
# ํ
์คํธ ์คํํด์ ํ์ฌ ์ํ ํ์ธ
pytest
# ๋ฒ๊ทธ ์ฌํ
from awesome_utils import format_date
from datetime import date
# 1970๋
์ด์ ๋ ์ง์์ ์ค๋ฅ ๋ฐ์
d = date(1960, 5, 15)
print(format_date(d)) # ์ค๋ฅ ๋ฐ์!
# ์ฝ๋ ํ์ธ
# utils/date.py ํ์ผ์์ timestamp() ์ฌ์ฉ์ด ๋ฌธ์
# timestamp()๋ 1970๋
์ด์ ๋ ์ง๋ฅผ ์ง์ ์ ํจ
git checkout -b fix/format-date-pre-1970
# utils/date.py ์์
# timestamp() ๋์ strftime() ์ฌ์ฉ์ผ๋ก ๋ณ๊ฒฝ
# tests/test_date.py์ ํ
์คํธ ์ถ๊ฐ
def test_format_date_pre_1970():
"""1970๋
์ด์ ๋ ์ง๋ ์ฌ๋ฐ๋ฅด๊ฒ ํฌ๋งท"""
d = date(1960, 5, 15)
assert format_date(d) == "1960-05-15"
# ํ
์คํธ ์คํ
pytest tests/test_date.py -v
# ๋ชจ๋ ํ
์คํธ ํต๊ณผ ํ์ธ!
git add utils/date.py tests/test_date.py
git commit -m "fix(date): handle dates before 1970 in format_date()
Use strftime() instead of timestamp() to support dates
before the Unix epoch (1970-01-01).
Fixes #42"
git push origin fix/format-date-pre-1970
GitHub์์ PR ์์ฑ ๋ฒํผ ํด๋ฆญ ํ ์ค๋ช ์์ฑ.
CI๊ฐ ์๋์ผ๋ก ์คํ๋๊ณ ์ด๋ก๋ถ ํ์ธ! โ
๋ฉ์ธํ ์ด๋: "Great fix! Could you also add a test for the year 2000?"
๋: "Sure! Done. I've added a test for year 2000 as well."
์ถ๊ฐ ์ปค๋ฐ ํ Push โ ๋ฉ์ธํ ์ด๋ ์น์ธ โ Merge! ๐
์์ ๋ฒ๊ทธ ์์ ํ๋์ง๋ง, ์ด๊ฒ ์์ด๋ฉด ์์ฒญ๋ ํฌํธํด๋ฆฌ์ค๊ฐ ๋ผ.
๊ทธ๋ฆฌ๊ณ ๋ฌด์๋ณด๋ค, ์ ์ธ๊ณ ์๋ง์ ์ฌ๋๋ค์ด ์ฐ๋ ์ฝ๋๋ฅผ ๊ฐ์ ํ๋ค๋ ๋ฟ๋ฏํจ! ๐
โก 11. ์์ฃผ ํ๋ ์ค์์ ํด๊ฒฐ๋ฒ
์คํ์์ค ๊ธฐ์ฌ๋ฅผ ์ฒ์ ํ๋ฉด ๋๊ตฌ๋ ์ค์๋ฅผ ํด.
๋ฏธ๋ฆฌ ์์๋๋ฉด ์ํ์ฐฉ์ค๋ฅผ ์ค์ผ ์ ์์ด! ๐ก๏ธ
์ค์ 1: main ๋ธ๋์น์์ ์ง์ ์์
โ ํด๊ฒฐ:
# ํญ์ ์ ๋ธ๋์น๋ฅผ ๋ง๋ค์ด์ ์์
ํด
git checkout -b fix/my-fix
# ์ค์๋ก main์์ ์์
ํ๋ค๋ฉด
git stash # ๋ณ๊ฒฝ์ฌํญ ์์ ์ ์ฅ
git checkout -b fix/my-fix # ์ ๋ธ๋์น ์์ฑ
git stash pop # ๋ณ๊ฒฝ์ฌํญ ๋ณต์
์ค์ 2: upstream ๋๊ธฐํ ์ ํ๊ณ PR
โ ํด๊ฒฐ:
# PR ์ ์ ํญ์ upstream ๋๊ธฐํ
git fetch upstream
git rebase upstream/main
# ์ถฉ๋ ํด๊ฒฐ ํ
git add .
git rebase --continue
์ค์ 3: ๋๋ฌด ํฐ PR
โ ํด๊ฒฐ:
ํ๋์ PR์ ํ๋์ ๋ชฉ์ ๋ง ๊ฐ์ ธ์ผ ํด.
"Fix bug A + Add feature B + Refactor C" ์ด๋ฐ PR์ ๋ฆฌ๋ทฐํ๊ธฐ ์ด๋ ค์.
๊ฐ๊ฐ ๋ณ๋์ PR๋ก ๋๋ ์ ์ ์ถํด.
์ค์ 4: ํ ์คํธ ์์ด PR
โ ํด๊ฒฐ:
๋ฒ๊ทธ ์์ โ ๋ฒ๊ทธ๋ฅผ ์ฌํํ๋ ํ ์คํธ ์ถ๊ฐ
์ ๊ธฐ๋ฅ โ ๊ธฐ๋ฅ์ ๊ฒ์ฆํ๋ ํ ์คํธ ์ถ๊ฐ
ํ ์คํธ ์๋ PR์ ๋๋ถ๋ถ ๊ฑฐ์ ๋นํด.
์ค์ 5: ์๋ต ์์ด ๋ฐฉ์น
โ ํด๊ฒฐ:
๋ฐ์๋ฉด "I'll address this by [๋ ์ง]" ๋ผ๊ณ ์๋ ค์ค.
์ฅ๊ธฐ๊ฐ ์๋ต์ด ์์ผ๋ฉด ๋ฉ์ธํ ์ด๋๊ฐ PR์ ๋ซ์ ์ ์์ด.
๋ชป ํ๊ฒ ์ผ๋ฉด ์์งํ๊ฒ "I'm unable to continue this. Feel free to close." ๋ผ๊ณ ํด.
์ค์ 6: ์ปค๋ฐ ๋ฉ์์ง ์๋ง
git commit -m "fix"
git commit -m "update again"
git commit -m "asdf"
git commit -m "final"
git commit -m "final2"
โ
์ข์ ์:
git commit -m "fix(parser): handle empty string input"
# ๋๋ ์ฌ๋ฌ ์ปค๋ฐ์ ํ๋๋ก ํฉ์น๊ธฐ (squash)
git rebase -i HEAD~5 # ์ต๊ทผ 5๊ฐ ์ปค๋ฐ ์ ๋ฆฌ
๐ 12. ๋ ๊น์ด ๋ค์ด๊ฐ๊ธฐ: ๋ฉ์ธํ ์ด๋๊ฐ ๋๋ ๊ธธ
๊ธฐ์ฌ๋ฅผ ๊พธ์คํ ํ๋ค ๋ณด๋ฉด ์ด๋ ์๊ฐ ๋ฉ์ธํ
์ด๋ ์ ์์ ๋ฐ์ ์ ์์ด.
๋๋ ์ง์ ์คํ์์ค ํ๋ก์ ํธ๋ฅผ ์์ํ ์๋ ์์ง.
๋ ๊น์ ์ฐธ์ฌ๋ฅผ ์ํ ๋ฐฉ๋ฒ๋ค์ ์์๋ณด์! ๐
๊พธ์คํ ๊ธฐ์ฌ์๊ฐ ๋๋ ๋ฐฉ๋ฒ
โ ํ๋ก์ ํธ ๊ตฌ์กฐ ํ์ , Git ์ํฌํ๋ก์ฐ ์ตํ๊ธฐ
๋ ๋ฒจ 2: ๋ฒ๊ทธ ์์ ๊ธฐ์ฌ
โ ์ฝ๋๋ฒ ์ด์ค ์ดํด, ํ ์คํธ ์์ฑ ๋ฅ๋ ฅ
๋ ๋ฒจ 3: ์ ๊ธฐ๋ฅ ๊ธฐ์ฌ
โ ์ค๊ณ ํ ๋ก ์ฐธ์ฌ, ํฐ ๊ทธ๋ฆผ ์ดํด
๋ ๋ฒจ 4: ์ฝ๋ ๋ฆฌ๋ทฐ์ด
โ ๋ค๋ฅธ ์ฌ๋์ PR ๋ฆฌ๋ทฐ, ์ด์ ํธ๋ฆฌ์์ง
๋ ๋ฒจ 5: ๋ฉ์ธํ ์ด๋
โ ํ๋ก์ ํธ ๋ฐฉํฅ ๊ฒฐ์ , ๋ฆด๋ฆฌ์ฆ ๊ด๋ฆฌ
Google Summer of Code (GSoC) ์ฐธ์ฌ
GSoC๋ ๊ตฌ๊ธ์ด ํ์ํ๋ ์คํ์์ค ๋ฉํ ๋ง ํ๋ก๊ทธ๋จ์ด์ผ.
๋งค๋
ํ์ด์ฌ ๊ด๋ จ ํ๋ก์ ํธ๋ค์ด ์ฐธ์ฌํ๊ณ , ํ์๋ค์๊ฒ ์คํฐํ๋(์ฅํ๊ธ)๋ ์ค.
์ฐธ์ฌ ๋ฐฉ๋ฒ:
๋๋ง์ ์คํ์์ค ํ๋ก์ ํธ ์์ํ๊ธฐ
๊ธฐ์ฌ ๊ฒฝํ์ด ์์ด๋ฉด ์ง์ ํ๋ก์ ํธ๋ฅผ ์์ํ ์๋ ์์ด.
์ฌ๋ฅ๋ท์์ ํ์ด์ฌ ๊ด๋ จ ์ฌ๋ฅ์ ๊ณต์ ํ๋ ๋ถ๋ค์ด๋ผ๋ฉด,
์์ ์ ๋๊ตฌ๋ฅผ ์คํ์์ค๋ก ๊ณต๊ฐํ๋ ๊ฒ๋ ํ๋ฅญํ ๋ฐฉ๋ฒ์ด์ผ! ๐ฑ
โก LICENSE - ๋ผ์ด์ ์ค ์ ํ (MIT, Apache 2.0 ๋ฑ)
โก CONTRIBUTING.md - ๊ธฐ์ฌ ๊ฐ์ด๋๋ผ์ธ
โก CODE_OF_CONDUCT.md - ํ๋ ๊ฐ๋ น
โก .github/ISSUE_TEMPLATE/ - ์ด์ ํ ํ๋ฆฟ
โก .github/PULL_REQUEST_TEMPLATE.md - PR ํ ํ๋ฆฟ
โก GitHub Actions - CI/CD ์ค์
โก PyPI ๋ฐฐํฌ ์ค์ (pyproject.toml)
โก ๋ฌธ์ ์ฌ์ดํธ (Read the Docs, GitHub Pages)
ํ์ด์ฌ ๋ผ์ด์ ์ค ์ ํ ๊ฐ์ด๋
| ๋ผ์ด์ ์ค | ํน์ง | ๋ํ ํ๋ก์ ํธ |
|---|---|---|
| MIT | ๊ฐ์ฅ ์์ ๋ก์. ์์ ์ ์ฌ์ฉ OK | Flask, Requests |
| Apache 2.0 | ํนํ ๋ณดํธ ํฌํจ. ๊ธฐ์ ์นํ์ | TensorFlow, Pandas |
| GPL v3 | ํ์ ์์ ๋ GPL์ด์ด์ผ ํจ | ์ผ๋ถ GNU ๋๊ตฌ |
| BSD 3-Clause | MIT์ ์ ์ฌ, ๊ด๊ณ ์กฐํญ ์์ | NumPy, SciPy |
| LGPL | ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋งํฌ๋ ์์ | ์ผ๋ถ ์์คํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ |
๐ ๏ธ 13. ํ์ ๋๊ตฌ ๋ชจ์: ์คํ์์ค ๊ธฐ์ฌ์์ ํดํท
ํจ์จ์ ์ธ ์คํ์์ค ๊ธฐ์ฌ๋ฅผ ์ํ ๋๊ตฌ๋ค์ ์ ๋ฆฌํด๋ณผ๊ฒ.
์ด ๋๊ตฌ๋ค์ ์ ํ์ฉํ๋ฉด ๊ธฐ์ฌ ์๋์ ํ์ง์ด ํ ์ฌ๋ผ๊ฐ! ๐ง
๊ฐ๋ฐ ๋๊ตฌ
| ์นดํ ๊ณ ๋ฆฌ | ๋๊ตฌ | ์ฉ๋ |
|---|---|---|
| ์๋ํฐ | VS Code, PyCharm | ์ฝ๋ ์์ฑ, Git ํตํฉ |
| ๋ฒ์ ๊ด๋ฆฌ | Git, GitHub CLI (gh) | ์ฝ๋ ๊ด๋ฆฌ, PR ์์ฑ |
| ํจํค์ง ๊ด๋ฆฌ | pip, Poetry, uv | ์์กด์ฑ ๊ด๋ฆฌ |
| ํ ์คํธ | pytest, coverage.py | ํ ์คํธ ์คํ, ์ปค๋ฒ๋ฆฌ์ง |
| ๋ฆฐํ | ruff, flake8, pylint | ์ฝ๋ ํ์ง ๊ฒ์ฌ |
| ํฌ๋งทํ | Black, autopep8 | ์ฝ๋ ์๋ ํฌ๋งท |
| ํ์ ์ฒดํฌ | mypy, pyright | ์ ์ ํ์ ๋ถ์ |
| ๋ฌธ์ํ | Sphinx, MkDocs | ๋ฌธ์ ์์ฑ |
GitHub CLI ํ์ฉํ๊ธฐ
GitHub CLI(gh)๋ฅผ ์ฌ์ฉํ๋ฉด ํฐ๋ฏธ๋์์ ๋ฐ๋ก PR์ ๋ง๋ค ์ ์์ด:
# GitHub CLI ์ค์น (macOS)
brew install gh
# ๋ก๊ทธ์ธ
gh auth login
# PR ์์ฑ
gh pr create --title "fix: handle float timeout" --body "Fixes #42"
# PR ๋ชฉ๋ก ๋ณด๊ธฐ
gh pr list
# ์ด์ ๋ชฉ๋ก ๋ณด๊ธฐ
gh issue list --label "good first issue"
# ์ด์ ์์ธ ๋ณด๊ธฐ
gh issue view 42
# ๋ ํฌ Fork
gh repo fork owner/repo --clone
VS Code ์ ์ฉํ ํ์ฅ ํ๋ก๊ทธ๋จ
โข Pylance - ํ์ ์ฒดํฌ, ์๋์์ฑ
โข GitLens - Git ํ์คํ ๋ฆฌ ์๊ฐํ
โข GitHub Pull Requests - VS Code์์ PR ๋ฆฌ๋ทฐ
โข Black Formatter - Black ์๋ ํฌ๋งท
โข Ruff - ๋น ๋ฅธ ๋ฆฐํ
โข Python Test Explorer - ํ ์คํธ ์๊ฐํ
โข Todo Tree - TODO ์ฃผ์ ์ถ์
๐ก 14. ์คํ์์ค ๊ธฐ์ฌ Q&A: ์์ฃผ ๋ฌป๋ ์ง๋ฌธ๋ค
์คํ์์ค ๊ธฐ์ฌ๋ฅผ ์์ํ๋ ค๋ ์ฌ๋๋ค์ด ์์ฃผ ํ๋ ์ง๋ฌธ๋ค์ ๋ชจ์๋ดค์ด.
ํน์ ์ด๋ฐ ๊ณ ๋ฏผ ํ๊ณ ์์์ด? ๐
"I'd like to work on this issue." "Fixed!" "Thank you for the review!"
์ด ์ ๋๋ฉด ์ถฉ๋ถํด. ๊ตฌ๊ธ ๋ฒ์ญ์ด๋ ChatGPT๋ฅผ ํ์ฉํด๋ ๋ผ.
๊ทธ๋ฆฌ๊ณ ํ๊ตญ์ด ๋ฌธ์ ๋ฒ์ญ ํ๋ก์ ํธ์ ๊ธฐ์ฌํ๋ฉด ํ๊ตญ์ด๋ก ๊ธฐ์ฌํ ์๋ ์์ด!
์คํ ์์ , ๋ฌธ์ ๊ฐ์ ๋ถํฐ ์์ํด๋ด. ์ฝ๋ ์ค๋ ฅ์ด ์์ด๋ ํ ์ ์๋ ์ผ์ด ๋ง์.
๊ทธ๋ฆฌ๊ณ ์ฝ๋ ๋ฆฌ๋ทฐ๋ฅผ ๋ฐ์ผ๋ฉด์ ์ค๋ ฅ์ด ๋น ๋ฅด๊ฒ ๋์ด. ์ค๋ ฅ์ด ๋ถ์กฑํ๋ค๊ณ ๋๋์๋ก ๋ ๊ธฐ์ฌํด์ผ ํด!
์ ๊ฑฐ์ ๋๋์ง ์ด์ ๋ฅผ ์ ์ฝ๊ณ , ๊ฐ์ ํด์ ๋ค์ ๋์ ํ๊ฑฐ๋
๋ค๋ฅธ ์ด์์ ๋์ ํด๋ด. ์ฒ์์๋ ๊ฑฐ์ ๋นํ๋ ๊ฒ ๋น์ฐํด.
์ ๋ช ํ ์ปจํธ๋ฆฌ๋ทฐํฐ๋ค๋ ์ฒ์์ PR์ด ๊ฑฐ์ ๋์ด.
๊พธ์คํจ์ด ์ค์ํด. ํ ๋ฒ์ ์์ฒญ๋ ๊ธฐ์ฌ๋ฅผ ํ๋ ๊ฒ๋ณด๋ค
์์ ๊ธฐ์ฌ๋ฅผ ๊พธ์คํ ํ๋ ๊ฒ ๋ ์ข์ ํํ์ ๋ง๋ค์ด.
CLA์ ์๋ช ํ๋ฉด ์ ์๊ถ์ ๋ณธ์ธ์ด ์ ์งํ๋, ํ๋ก์ ํธ์ ์ฌ์ฉ ๊ถํ์ ๋ถ์ฌํ๋ ๊ฑฐ์ผ.
์ผ๋ถ ํ๋ก์ ํธ๋ ์ ์๊ถ์ ์ฌ๋จ์ ์๋ํ๊ธฐ๋ ํด (์: PSF).
๊ธฐ์ฌ ์ ์ CONTRIBUTING.md์์ CLA ๊ด๋ จ ๋ด์ฉ์ ํ์ธํด๋ด.
"Contributed to [ํ๋ก์ ํธ๋ช ] (GitHub Stars: X,XXX): Fixed [๋ฒ๊ทธ ์ค๋ช ], added [๊ธฐ๋ฅ ์ค๋ช ]"
GitHub ํ๋กํ ๋งํฌ๋ ํจ๊ป ์ฒจ๋ถํด. ๋ฉด์ ๊ด์ด ์ง์ ํ์ธํ ์ ์์ด.
ํนํ ์ ๋ช ํ ํ๋ก์ ํธ์ ๊ธฐ์ฌํ๋ค๋ฉด ๋์ฑ ๊ฐ์กฐํด๋ด.
๐ฏ 15. ์ค๋ ๋น์ฅ ์์ํ๋ ์ก์ ํ๋
์, ์ด์ ์ถฉ๋ถํ ๋ฐฐ์ ์ด. ์ด๋ก ์ ๊ทธ๋งํ๊ณ ์ค์ ์ผ๋ก ๊ฐ์!
์ค๋ ๋น์ฅ ํ ์ ์๋ ๊ฒ๋ค์ ๋จ๊ณ๋ณ๋ก ์ ๋ฆฌํด์ค๊ฒ. ๐โโ๏ธ
โข GitHub ๊ณ์ ๋ง๋ค๊ธฐ (์๋ค๋ฉด)
โข ํ์์ ์์ฃผ ์ฐ๋ ํ์ด์ฌ ๋ผ์ด๋ธ๋ฌ๋ฆฌ GitHub ํ์ด์ง ๋ฐฉ๋ฌธ
โข Issues ํญ์์ good first issue ๋ผ๋ฒจ ์ด์ 3๊ฐ ์ฐพ๊ธฐ
โข ๋ง์์ ๋๋ ์ด์ ํ๋ ์ ํ
โข ๋ ํฌ Fork ๋ฐ Clone
โข ๊ฐ๋ฐ ํ๊ฒฝ ์ธํ (venv, ์์กด์ฑ ์ค์น)
โข CONTRIBUTING.md ์ฝ๊ธฐ
โข ์ด์ ๋๊ธ๋ก ์์ ์์ฌ ํ๋ช
โข ์ฝ๋ ์์ ๋ฐ ํ ์คํธ ์์ฑ
โข ์ฒซ ๋ฒ์งธ PR ์ ์ถ!
โข ๋ฆฌ๋ทฐ ํผ๋๋ฐฑ ๋ฐ์
โข ์ฒซ ๋ฒ์งธ PR Merge ๋ฌ์ฑ ๐
โข ๋ ๋ฒ์งธ ์ด์ ๋์
โข 5๊ฐ ์ด์์ ๊ธฐ์ฌ ์ด๋ ฅ
โข ์ฝ๋ ๋ฆฌ๋ทฐ์ด๋ก ์ฐธ์ฌ
โข ๋ ๋ณต์กํ ์ด์ ๋์
์คํ์์ค ๊ธฐ์ฌ๋ ๋ง์ฐฌ๊ฐ์ง์ผ. ์ง๊ธ ์์ํ๋ ๊ฒ ์ต์ ์ด์ผ. ๐ณ
๋ธ๋ก๊ทธ์ ํ๊ธฐ๋ฅผ ์ฐ๊ฑฐ๋, ์ฌ๋ฅ๋ท ๊ฐ์ ํ๋ซํผ์์ ๊ฒฝํ์ ๊ณต์ ํด๋ด.
๋ค๋ฅธ ์ฌ๋๋ค์๊ฒ ์๊ฐ์ ์ฃผ๋ ๊ฒ๋ ํ๋ฅญํ ๊ธฐ์ฌ์ผ! โจ
๐ ๋ง๋ฌด๋ฆฌ: ์คํ์์ค๋ ํจ๊ป ๋ง๋๋ ๊ฒ
์ฌ๊ธฐ๊น์ง ์ฝ์ด์ค์ ๊ณ ๋ง์! ์ ๋ง ๊ธด ์ฌ์ ์ด์์ง? ๐
์คํ์์ค ๊ธฐ์ฌ๋ ๋จ์ํ ์ฝ๋๋ฅผ ์ฌ๋ฆฌ๋ ๊ฒ ์๋์ผ.
์ ์ธ๊ณ ๊ฐ๋ฐ์๋ค๊ณผ ํจ๊ป ๋ ๋์ ์ํํธ์จ์ด๋ฅผ ๋ง๋๋ ๊ณผ์ ์ด์ผ.
๋ด๊ฐ ๊ณ ์น ๋ฒ๊ทธ ํ๋๊ฐ ์๋ฐฑ๋ง ๋ช
์ ๊ฐ๋ฐ์์๊ฒ ๋์์ด ๋ ์ ์์ด.
๊ทธ ๋ฟ๋ฏํจ์ ๊ฒฝํํด๋ณธ ์ฌ๋๋ง ์์. ๐
ํ์ด์ฌ ์ํ๊ณ๋ ์ ๋ง ๋ฐ๋ปํ ์ปค๋ฎค๋ํฐ์ผ.
์ค์ํด๋ ๊ด์ฐฎ๊ณ , ์ง๋ฌธํด๋ ๊ด์ฐฎ์.
๋ชจ๋๊ฐ ์ฒ์์ ์ด๋ณด์์๊ฑฐ๋ .
์ค๋ ์ฒซ ๋ฒ์งธ ์ด์๋ฅผ ์ฐพ์๋ด. ๊ทธ๊ฒ ์์์ด์ผ.
ํ์ดํ
! ๐๐
๊ด๋ จ ํค์๋
๋๊ธ ์์ฑ
์ด ๊ธ์ ๋ํ ์ฌ๋ฌ๋ถ์ ์๊ฐ์ ๋ค๋ ค์ฃผ์ธ์
๋ก๊ทธ์ธ์ด ํ์ํฉ๋๋ค
๋๊ธ์ ์์ฑํ๋ ค๋ฉด ๋จผ์ ๋ก๊ทธ์ธํด์ฃผ์ธ์.
๋๊ธ 0
์ง์์ธ์ ์ฒ - ์ง์ ์ฌ์ฐ๊ถ ๋ณดํธ ๊ณ ์ง
์ง์ ์ฌ์ฐ๊ถ ๋ณดํธ ๊ณ ์ง
- ์ ์๊ถ ๋ฐ ์์ ๊ถ: ๋ณธ ์ปจํ ์ธ ๋ ์ฌ๋ฅ๋ท์ ๋ ์ AI ๊ธฐ์ ๋ก ์์ฑ๋์์ผ๋ฉฐ, ๋ํ๋ฏผ๊ตญ ์ ์๊ถ๋ฒ ๋ฐ ๊ตญ์ ์ ์๊ถ ํ์ฝ์ ์ํด ๋ณดํธ๋ฉ๋๋ค.
- AI ์์ฑ ์ปจํ ์ธ ์ ๋ฒ์ ์ง์: ๋ณธ AI ์์ฑ ์ปจํ ์ธ ๋ ์ฌ๋ฅ๋ท์ ์ง์ ์ฐฝ์๋ฌผ๋ก ์ธ์ ๋๋ฉฐ, ๊ด๋ จ ๋ฒ๊ท์ ๋ฐ๋ผ ์ ์๊ถ ๋ณดํธ๋ฅผ ๋ฐ์ต๋๋ค.
- ์ฌ์ฉ ์ ํ: ์ฌ๋ฅ๋ท์ ๋ช ์์ ์๋ฉด ๋์ ์์ด ๋ณธ ์ปจํ ์ธ ๋ฅผ ๋ณต์ , ์์ , ๋ฐฐํฌ, ๋๋ ์์ ์ ์ผ๋ก ํ์ฉํ๋ ํ์๋ ์๊ฒฉํ ๊ธ์ง๋ฉ๋๋ค.
- ๋ฐ์ดํฐ ์์ง ๊ธ์ง: ๋ณธ ์ปจํ ์ธ ์ ๋ํ ๋ฌด๋จ ์คํฌ๋ํ, ํฌ๋กค๋ง, ๋ฐ ์๋ํ๋ ๋ฐ์ดํฐ ์์ง์ ๋ฒ์ ์ ์ฌ์ ๋์์ด ๋ฉ๋๋ค.
- AI ํ์ต ์ ํ: ์ฌ๋ฅ๋ท์ AI ์์ฑ ์ปจํ ์ธ ๋ฅผ ํ AI ๋ชจ๋ธ ํ์ต์ ๋ฌด๋จ ์ฌ์ฉํ๋ ํ์๋ ๊ธ์ง๋๋ฉฐ, ์ด๋ ์ง์ ์ฌ์ฐ๊ถ ์นจํด๋ก ๊ฐ์ฃผ๋ฉ๋๋ค.
์์ง ๋๊ธ์ด ์์ต๋๋ค.