์ฝ˜ํ…์ธ  ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ - ๐Ÿ ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌํ•˜๊ธฐ: ํŒŒ์ด์ฌ ํ”„๋กœ์ ํŠธ์— ์ฐธ์—ฌํ•˜๊ณ  ์‹ค๋ ฅ์„ ํ‚ค์šฐ๋Š” ํ˜„์‹ค์ ์ธ ๋ฐฉ๋ฒ•
Python ยท ํ”„๋กœ๊ทธ๋žจ๊ฐœ๋ฐœ

๐Ÿ ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌํ•˜๊ธฐ: ํŒŒ์ด์ฌ ํ”„๋กœ์ ํŠธ์— ์ฐธ์—ฌํ•˜๊ณ  ์‹ค๋ ฅ์„ ํ‚ค์šฐ๋Š” ํ˜„์‹ค์ ์ธ ๋ฐฉ๋ฒ•

์ฒ˜์Œ PR ๋‚ ๋ฆฌ๋Š” ์ˆœ๊ฐ„๋ถ€ํ„ฐ, ๋ฉ”์ธํ…Œ์ด๋„ˆ๊ฐ€ ๋˜๋Š” ๊ทธ๋‚ ๊นŒ์ง€ ๐Ÿš€

์•ผ, ์†”์งํžˆ ๋งํ•ด๋ณผ๊ฒŒ. ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ๋ผ๋Š” ๋ง ๋“ค์œผ๋ฉด ์–ด๋–ค ๋А๋‚Œ์ด์•ผ? ๐Ÿค”
"๋‚˜ ๊ฐ™์€ ์ดˆ๋ณด๊ฐ€ ๊ฐํžˆ?"๋ผ๋Š” ์ƒ๊ฐ์ด ๋จผ์ € ๋“œ๋Š” ์‚ฌ๋žŒ, ์† ๋“ค์–ด๋ด.
์•„๋‹ˆ๋ฉด "์–ธ์  ๊ฐ€๋Š” ํ•ด๋ด์•ผ์ง€..." ํ•˜๋ฉด์„œ ๋ช‡ ๋‹ฌ์งธ ๋ฏธ๋ฃจ๊ณ  ์žˆ๋Š” ์‚ฌ๋žŒ๋„ ์žˆ์„ ๊ฑฐ์•ผ.

๊ทผ๋ฐ ์žˆ์ž–์•„, ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ๋Š” ์ƒ๊ฐ๋ณด๋‹ค ํ›จ์”ฌ ๊ฐ€๊นŒ์ด ์žˆ์–ด.
์˜คํƒ€ ํ•˜๋‚˜ ๊ณ ์น˜๋Š” ๊ฒƒ๋„, ๋ฌธ์„œ ํ•œ ์ค„ ๋ฒˆ์—ญํ•˜๋Š” ๊ฒƒ๋„ ๋‹ค ๊ธฐ์—ฌ์•ผ.
๊ทธ๋ฆฌ๊ณ  ํŒŒ์ด์ฌ ์ƒํƒœ๊ณ„๋Š” ํŠนํžˆ ์ž…๋ฌธ์ž์—๊ฒŒ ์นœ์ ˆํ•œ ์ปค๋ฎค๋‹ˆํ‹ฐ๋กœ ์œ ๋ช…ํ•˜๊ฑฐ๋“ .

์ด ๊ธ€์—์„œ๋Š” ํŒŒ์ด์ฌ ์˜คํ”ˆ์†Œ์Šค ํ”„๋กœ์ ํŠธ์— ๊ธฐ์—ฌํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์ฒ˜์Œ๋ถ€ํ„ฐ ๋๊นŒ์ง€, ์ง„์งœ ํ˜„์‹ค์ ์œผ๋กœ ํ’€์–ด๋ณผ๊ฒŒ.
์ด๋ก ๋งŒ ๋Š˜์–ด๋†“๋Š” ๊ธ€ ๋ง๊ณ , ์‹ค์ œ๋กœ ์จ๋จน์„ ์ˆ˜ ์žˆ๋Š” ๋‚ด์šฉ์œผ๋กœ! ๐Ÿ’ช


์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ ์—ฌ์ • ํ•œ๋ˆˆ์— ๋ณด๊ธฐ โ‘  ํ”„๋กœ์ ํŠธ ํƒ์ƒ‰ & ์„ ํƒ โ‘ก Fork & Clone โ‘ข ์ด์Šˆ ํŒŒ์•… & ๋ธŒ๋žœ์น˜ ์ƒ์„ฑ โ‘ฃ ์ฝ”๋“œ ์ž‘์„ฑ & ํ…Œ์ŠคํŠธ โ‘ค PR ์ œ์ถœ & ๋ฆฌ๋ทฐ ๋Œ€์‘ good first issue ํƒœ๊ทธ ํ™œ์šฉํ•˜๊ธฐ โ˜… ์ดˆ๋ณด์ž ์ถ”์ฒœ git fork ํ›„ ๋กœ์ปฌ ํ™˜๊ฒฝ ์„ธํŒ… venv ํ•„์ˆ˜! ์ด์Šˆ ๋Œ“๊ธ€๋กœ ์ž‘์—… ์˜์‚ฌ ํ‘œ๋ช… ๋จผ์ € ์†Œํ†ต! pytest ๋“ฑ์œผ๋กœ ํ…Œ์ŠคํŠธ ํ†ต๊ณผ ํ™•์ธ CI ๊ทธ๋ฆฐ ์ฒดํฌ! ๋ฆฌ๋ทฐ ํ”ผ๋“œ๋ฐฑ ๊ฒธ์†ํ•˜๊ฒŒ ์ˆ˜์šฉ Merge ๐ŸŽ‰ ๐Ÿ ํŒŒ์ด์ฌ ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ, ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ๋ผ! ์ฒ˜์Œ์—” ๋ฌธ์„œ ์ˆ˜์ •, ์˜คํƒ€ ๊ต์ •๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด๋„ ์ถฉ๋ถ„ํ•ด. ์ž‘์€ ๊ธฐ์—ฌ ํ•˜๋‚˜๊ฐ€ ์Œ“์ด๋ฉด ์–ด๋А์ƒˆ ํ•ต์‹ฌ ์ปจํŠธ๋ฆฌ๋ทฐํ„ฐ๊ฐ€ ๋˜์–ด ์žˆ์„ ๊ฑฐ์•ผ! ๋ˆ„๊ตฌ๋‚˜ ์ฒซ ๋ฒˆ์งธ PR์ด ์žˆ์—ˆ๋‹ค. ์ง€๊ธˆ ์‹œ์ž‘ํ•ด! ๐Ÿš€

๐ŸŒฑ 1. ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ, ์™œ ํŒŒ์ด์ฌ์ธ๊ฐ€?

ํŒŒ์ด์ฌ์€ ์ „ ์„ธ๊ณ„์—์„œ ๊ฐ€์žฅ ํ™œ๋ฐœํ•œ ์˜คํ”ˆ์†Œ์Šค ์ƒํƒœ๊ณ„ ์ค‘ ํ•˜๋‚˜์•ผ.
GitHub์—์„œ ํŒŒ์ด์ฌ ๊ด€๋ จ ๋ ˆํฌ์ง€ํ† ๋ฆฌ ์ˆ˜๋Š” ์ˆ˜๋ฐฑ๋งŒ ๊ฐœ์— ๋‹ฌํ•˜๊ณ ,
NumPy, Pandas, Django, Flask, FastAPI, Requests, Scikit-learn ๊ฐ™์€ ์ดˆ๋Œ€ํ˜• ํ”„๋กœ์ ํŠธ๋“ค์ด ๋ชจ๋‘ ์˜คํ”ˆ์†Œ์Šค๋กœ ์šด์˜๋˜๊ณ  ์žˆ์–ด.

ํŒŒ์ด์ฌ ์ปค๋ฎค๋‹ˆํ‹ฐ๊ฐ€ ํŠนํžˆ ์ž…๋ฌธ์ž ์นœํ™”์ ์ธ ์ด์œ ๊ฐ€ ๋ช‡ ๊ฐ€์ง€ ์žˆ์–ด:

๐Ÿค ํŒŒ์ด์ฌ ์ปค๋ฎค๋‹ˆํ‹ฐ์˜ ํŠน์ง• 1. ๋ช…ํ™•ํ•œ ํ–‰๋™ ๊ฐ•๋ น(Code of Conduct)
ํŒŒ์ด์ฌ ์†Œํ”„ํŠธ์›จ์–ด ์žฌ๋‹จ(PSF)์€ ๊ณต์‹์ ์ธ ํ–‰๋™ ๊ฐ•๋ น์„ ์šด์˜ํ•ด.
๋ชจ๋“  ํŒŒ์ด์ฌ ๊ด€๋ จ ์ปค๋ฎค๋‹ˆํ‹ฐ์—์„œ ์กด์ค‘๊ณผ ํฌ์šฉ์„ ๊ฐ•์กฐํ•˜๊ธฐ ๋•Œ๋ฌธ์—
์ดˆ๋ณด์ž๋„ ์งˆ๋ฌธํ•˜๊ธฐ ํŽธํ•œ ๋ถ„์œ„๊ธฐ์•ผ.

2. ํ’๋ถ€ํ•œ ๋ฌธ์„œํ™” ๋ฌธํ™”
ํŒŒ์ด์ฌ ํ”„๋กœ์ ํŠธ๋“ค์€ ๋Œ€์ฒด๋กœ CONTRIBUTING.md, README, ์œ„ํ‚ค ๋“ฑ์ด ์ž˜ ์ •๋น„๋˜์–ด ์žˆ์–ด.
์–ด๋–ป๊ฒŒ ๊ธฐ์—ฌํ•ด์•ผ ํ•˜๋Š”์ง€ ๊ฐ€์ด๋“œ๋ผ์ธ์ด ๋ช…ํ™•ํ•˜๊ฒŒ ๋‚˜์™€ ์žˆ๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์•„.

3. ๋‹ค์–‘ํ•œ ๊ธฐ์—ฌ ์œ ํ˜•
์ฝ”๋“œ๋งŒ์ด ๊ธฐ์—ฌ๊ฐ€ ์•„๋‹ˆ์•ผ. ๋ฌธ์„œ ๋ฒˆ์—ญ, ๋ฒ„๊ทธ ๋ฆฌํฌํŠธ, ํ…Œ์ŠคํŠธ ์ž‘์„ฑ, ์˜ˆ์ œ ์ฝ”๋“œ ์ถ”๊ฐ€ ๋“ฑ
๋‹ค์–‘ํ•œ ๋ฐฉ์‹์œผ๋กœ ์ฐธ์—ฌํ•  ์ˆ˜ ์žˆ์–ด.

4. ํ™œ๋ฐœํ•œ ๋ฉ˜ํ† ๋ง ํ”„๋กœ๊ทธ๋žจ
Google Summer of Code(GSoC), Outreachy ๊ฐ™์€ ๊ณต์‹ ๋ฉ˜ํ† ๋ง ํ”„๋กœ๊ทธ๋žจ์—
ํŒŒ์ด์ฌ ํ”„๋กœ์ ํŠธ๋“ค์ด ๋งค๋…„ ์ฐธ์—ฌํ•ด. ์ฒด๊ณ„์ ์œผ๋กœ ๋ฐฐ์šธ ์ˆ˜ ์žˆ๋Š” ๊ธฐํšŒ๊ฐ€ ์žˆ์–ด.

๊ทธ๋ฆฌ๊ณ  ์†”์งํžˆ ๋งํ•˜๋ฉด, ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ๋Š” ์ทจ์—… ์ค€๋น„์—๋„ ์—„์ฒญ๋‚œ ๋„์›€์ด ๋ผ.
์‹ค์ œ๋กœ ๋งŽ์€ ํ…Œํฌ ๊ธฐ์—…๋“ค์ด GitHub ํ”„๋กœํ•„์„ ํฌํŠธํด๋ฆฌ์˜ค๋กœ ๋ณด๊ฑฐ๋“ .
์œ ๋ช… ํ”„๋กœ์ ํŠธ์— ๊ธฐ์—ฌ ์ด๋ ฅ์ด ์žˆ์œผ๋ฉด ๋ฉด์ ‘์—์„œ ํ™•์‹คํžˆ ๋ˆˆ์— ๋„์–ด.

์žฌ๋Šฅ๋„ท ๊ฐ™์€ ํ”Œ๋žซํผ์—์„œ ํŒŒ์ด์ฌ ๊ด€๋ จ ์žฌ๋Šฅ์„ ๊ฑฐ๋ž˜ํ•˜๋Š” ๋ถ„๋“ค๋„ ๋งŽ์€๋ฐ,
์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ ๊ฒฝํ—˜์€ ์ž์‹ ์˜ ์‹ค๋ ฅ์„ ๊ฐ๊ด€์ ์œผ๋กœ ์ฆ๋ช…ํ•˜๋Š” ์ตœ๊ณ ์˜ ๋ฐฉ๋ฒ• ์ค‘ ํ•˜๋‚˜์•ผ. ๐Ÿ’ผ

๐Ÿ’ก Tip: ํŒŒ์ด์ฌ ๊ณต์‹ ๋ฌธ์„œ(docs.python.org)๋„ ์˜คํ”ˆ์†Œ์Šค์•ผ!
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 ๋งํฌ ํ™•์ธ

์ž…๋ฌธ์ž์—๊ฒŒ ์ถ”์ฒœํ•˜๋Š” ํŒŒ์ด์ฌ ํ”„๋กœ์ ํŠธ๋“ค

๐Ÿฃ ์ดˆ๋ณด์ž ์นœํ™”์  ํ”„๋กœ์ ํŠธ โ€ข Requests - HTTP ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ. ์ฝ”๋“œ๊ฐ€ ๊น”๋”ํ•˜๊ณ  ๋ฌธ์„œํ™”๊ฐ€ ์ž˜ ๋˜์–ด ์žˆ์–ด.
โ€ข Rich - ํ„ฐ๋ฏธ๋„ ์ถœ๋ ฅ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ. ํ™œ๋ฐœํ•œ ์ปค๋ฎค๋‹ˆํ‹ฐ์™€ ์นœ์ ˆํ•œ ๋ฉ”์ธํ…Œ์ด๋„ˆ.
โ€ข Click - CLI ๋„๊ตฌ ์ œ์ž‘ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ. ์ด์Šˆ ํŠธ๋ž˜์ปค๊ฐ€ ์ž˜ ๊ด€๋ฆฌ๋จ.
โ€ข Pillow - ์ด๋ฏธ์ง€ ์ฒ˜๋ฆฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ. ๋‹ค์–‘ํ•œ ๋‚œ์ด๋„์˜ ์ด์Šˆ ์กด์žฌ.
โ€ข Python-dateutil - ๋‚ ์งœ ์ฒ˜๋ฆฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ. ๋น„๊ต์  ์ž‘์€ ์ฝ”๋“œ๋ฒ ์ด์Šค.

๐Ÿ“š ๋ฌธ์„œ ๊ธฐ์—ฌ์— ์ข‹์€ ํ”„๋กœ์ ํŠธ

โ€ข CPython - ํŒŒ์ด์ฌ ๊ณต์‹ ๋ฌธ์„œ ๊ฐœ์„ 
โ€ข Django - ๋ฐฉ๋Œ€ํ•œ ๋ฌธ์„œ, ๋ฒˆ์—ญ ๊ธฐ์—ฌ ๊ฐ€๋Šฅ
โ€ข Pandas - ์˜ˆ์ œ ์ฝ”๋“œ ์ถ”๊ฐ€, ์„ค๋ช… ๊ฐœ์„ 
๐Ÿ’ก ์‹ค์ „ ํŒ: GitHub์—์„œ label:"good first issue" language:python ์œผ๋กœ ๊ฒ€์ƒ‰ํ•˜๋ฉด
ํŒŒ์ด์ฌ ํ”„๋กœ์ ํŠธ์˜ ์ดˆ๋ณด์ž์šฉ ์ด์Šˆ๋ฅผ ํ•œ ๋ฒˆ์— ์ฐพ์„ ์ˆ˜ ์žˆ์–ด!

โš™๏ธ 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 ์„ค์ •

์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ์˜ ํ‘œ์ค€ ์›Œํฌํ”Œ๋กœ์šฐ์•ผ. ์ˆœ์„œ๋Œ€๋กœ ๋”ฐ๋ผํ•ด๋ด:

1
GitHub์—์„œ Fork
๊ธฐ์—ฌํ•˜๊ณ  ์‹ถ์€ ๋ ˆํฌ์ง€ํ† ๋ฆฌ ํŽ˜์ด์ง€์—์„œ ์šฐ์ธก ์ƒ๋‹จ Fork ๋ฒ„ํŠผ ํด๋ฆญ.
๋‚ด GitHub ๊ณ„์ •์— ๋ณต์‚ฌ๋ณธ์ด ์ƒ๊ฒจ.
2
๋กœ์ปฌ์— Clone
# ๋‚ด Fork๋ฅผ ๋กœ์ปฌ์— ํด๋ก 
git clone https://github.com/๋‚ด๊ณ„์ •/ํ”„๋กœ์ ํŠธ๋ช….git
cd ํ”„๋กœ์ ํŠธ๋ช…
3
Upstream ์›๋ณธ ๋ ˆํฌ ์—ฐ๊ฒฐ
# ์›๋ณธ ๋ ˆํฌ๋ฅผ 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)
4
๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ ๋ฐ ์˜์กด์„ฑ ์„ค์น˜
# ๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ (ํŒŒ์ด์ฌ 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 ์—ฌ๋Ÿฌ ํŒŒ์ด์ฌ ๋ฒ„์ „ ํ…Œ์ŠคํŠธ
๐Ÿ’ก Tip: pip install -e . ์˜ -e ํ”Œ๋ž˜๊ทธ๋Š” "editable mode"์•ผ.
์†Œ์Šค ์ฝ”๋“œ๋ฅผ ์ˆ˜์ •ํ•˜๋ฉด ์ฆ‰์‹œ ๋ฐ˜์˜๋˜๊ธฐ ๋•Œ๋ฌธ์— ๊ฐœ๋ฐœํ•  ๋•Œ ํ•„์ˆ˜์•ผ.
๋งค๋ฒˆ ์žฌ์„ค์น˜ํ•  ํ•„์š”๊ฐ€ ์—†์–ด์„œ ์—„์ฒญ ํŽธํ•ด!

๐Ÿ”€ Git ๋ธŒ๋žœ์น˜ ์ „๋žต & PR ์›Œํฌํ”Œ๋กœ์šฐ ์›๋ณธ ๋ ˆํฌ์ง€ํ† ๋ฆฌ (upstream/main) Fork ๋‚ด Fork ๋ ˆํฌ (origin/main) Clone ๋กœ์ปฌ main ๋ธŒ๋žœ์น˜ (local/main) ๋ธŒ๋žœ์น˜ ์ƒ์„ฑ ์ž‘์—… ๋ธŒ๋žœ์น˜ (feature/fix-xxx) Push PR ์ œ์ถœ ํ•ต์‹ฌ ๋ช…๋ น์–ด git checkout -b ๋ธŒ๋žœ์น˜๋ช… โ†’ ์ž‘์—… ๋ธŒ๋žœ์น˜ ์ƒ์„ฑ git add . && git commit โ†’ ๋ณ€๊ฒฝ์‚ฌํ•ญ ์ปค๋ฐ‹ git push origin ๋ธŒ๋žœ์น˜๋ช… โ†’ Fork์— Push GitHub์—์„œ PR ์ƒ์„ฑ โ†’ ์›๋ณธ ๋ ˆํฌ์— PR git fetch upstream โ†’ ์ตœ์‹  ์ƒํƒœ ๋™๊ธฐํ™”

๐Ÿ› 4. ์ด์Šˆ ํŒŒ์•…ํ•˜๊ธฐ: ๋ฌด์—‡์„ ๊ณ ์น ๊นŒ?

ํ™˜๊ฒฝ ์„ธํŒ…์ด ๋๋‚ฌ์œผ๋ฉด ์ด์ œ ์‹ค์ œ๋กœ ๋ญ˜ ํ• ์ง€ ์ •ํ•ด์•ผ ํ•ด.
์ด์Šˆ ํŠธ๋ž˜์ปค๋ฅผ ์ฝ๋Š” ๊ฒƒ๋„ ํ•˜๋‚˜์˜ ๊ธฐ์ˆ ์ด์•ผ. ์ž˜ ์ฝ๋Š” ๋ฒ•์„ ์•Œ์•„๋ณด์ž! ๐Ÿ‘€

์ด์Šˆ ๋ผ๋ฒจ ์ดํ•ดํ•˜๊ธฐ

GitHub ์ด์Šˆ์—๋Š” ๋‹ค์–‘ํ•œ ๋ผ๋ฒจ์ด ๋ถ™์–ด ์žˆ์–ด. ์ฃผ์š” ๋ผ๋ฒจ๋“ค์„ ์•Œ์•„๋‘๋ฉด ๋„์›€์ด ๋ผ:

๋ผ๋ฒจ ์˜๋ฏธ ์ถ”์ฒœ ๋Œ€์ƒ
good first issue ์ž…๋ฌธ์ž์—๊ฒŒ ์ ํ•ฉํ•œ ์ด์Šˆ โญ ์ดˆ๋ณด์ž ๊ฐ•๋ ฅ ์ถ”์ฒœ
help wanted ๋„์›€์ด ํ•„์š”ํ•œ ์ด์Šˆ ์ค‘๊ธ‰์ž ์ถ”์ฒœ
bug ๋ฒ„๊ทธ ์ˆ˜์ • ํ•„์š” ์ฝ”๋“œ ์ดํ•ด ํ›„ ๋„์ „
documentation ๋ฌธ์„œ ๊ด€๋ จ ์ด์Šˆ โญ ์ดˆ๋ณด์ž ์ถ”์ฒœ
enhancement ๊ธฐ๋Šฅ ๊ฐœ์„  ์š”์ฒญ ์ค‘~๊ณ ๊ธ‰์ž
duplicate ์ค‘๋ณต ์ด์Šˆ ๊ฑด๋“œ๋ฆฌ์ง€ ๋งˆ
wontfix ์ˆ˜์ • ์•ˆ ํ•  ์ด์Šˆ ๊ฑด๋“œ๋ฆฌ์ง€ ๋งˆ

์ด์Šˆ ์„ ํƒ ์ „ ์ฒดํฌ๋ฆฌ์ŠคํŠธ

๐Ÿ“‹ ์ด์Šˆ ์„ ํƒ ์ „ ํ™•์ธ์‚ฌํ•ญ โ–ก ์ด๋ฏธ ๋ˆ„๊ตฐ๊ฐ€ ์ž‘์—… ์ค‘์ธ๊ฐ€?
์ด์Šˆ ๋Œ“๊ธ€์— "I'll work on this" ๊ฐ™์€ ๋ง์ด ์žˆ์œผ๋ฉด ์ด๋ฏธ ๋ˆ„๊ตฐ๊ฐ€ ์ž‘์—… ์ค‘์ผ ์ˆ˜ ์žˆ์–ด.
์ค‘๋ณต ์ž‘์—…์„ ํ”ผํ•˜๊ธฐ ์œ„ํ•ด ๋จผ์ € ํ™•์ธํ•ด.

โ–ก ์—ฐ๊ฒฐ๋œ PR์ด ์žˆ๋Š”๊ฐ€?
์ด์Šˆ ํŽ˜์ด์ง€์— ์—ฐ๊ฒฐ๋œ PR์ด ์žˆ์œผ๋ฉด ์ด๋ฏธ ๋ˆ„๊ตฐ๊ฐ€ ํ•ด๊ฒฐ ์ค‘์ธ ๊ฑฐ์•ผ.

โ–ก ์ด์Šˆ๊ฐ€ ๋ช…ํ™•ํ•˜๊ฒŒ ์ •์˜๋˜์–ด ์žˆ๋Š”๊ฐ€?
๋ญ˜ ํ•ด์•ผ ํ•˜๋Š”์ง€ ๋ชจํ˜ธํ•œ ์ด์Šˆ๋Š” ์ดˆ๋ณด์ž์—๊ฒŒ ์–ด๋ ค์›Œ.
๋ช…ํ™•ํ•˜๊ฒŒ "์ด ํŒŒ์ผ์˜ ์ด ๋ถ€๋ถ„์„ ์ˆ˜์ •ํ•ด๋ผ"๋Š” ์‹์˜ ์ด์Šˆ๊ฐ€ ์ข‹์•„.

โ–ก ๋‚ด ์‹ค๋ ฅ ์ˆ˜์ค€์— ๋งž๋Š”๊ฐ€?
์š•์‹ฌ๋‚ด์ง€ ๋ง๊ณ  ๋‚ด ์ˆ˜์ค€์— ๋งž๋Š” ์ด์Šˆ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด.
์ž‘์€ ์„ฑ๊ณต ๊ฒฝํ—˜์ด ์Œ“์—ฌ์•ผ ๋” ํฐ ๊ธฐ์—ฌ๋ฅผ ํ•  ์ˆ˜ ์žˆ์–ด.

์ด์Šˆ์— ๋Œ“๊ธ€ ๋‹ฌ๊ธฐ: ์ž‘์—… ์˜์‚ฌ ํ‘œ๋ช…

์ด์Šˆ๋ฅผ ๊ณจ๋ž์œผ๋ฉด ๋ฐ”๋กœ ์ฝ”๋“œ ์งœ๋Ÿฌ ๊ฐ€์ง€ ๋ง๊ณ , ๋จผ์ € ๋Œ“๊ธ€์„ ๋‹ฌ์•„์•ผ ํ•ด!
์ด๊ฒŒ ์˜คํ”ˆ์†Œ์Šค ์—ํ‹ฐ์ผ“์ด์•ผ. ์ด๋Ÿฐ ์‹์œผ๋กœ ์จ๋ด:

๐Ÿ’ฌ ์ด์Šˆ ๋Œ“๊ธ€ ์˜ˆ์‹œ (์˜์–ด๋กœ ์จ์•ผ ํ•ด) "Hi! I'd like to work on this issue. I'm planning to [๊ฐ„๋‹จํ•œ ์ ‘๊ทผ ๋ฐฉ๋ฒ• ์„ค๋ช…]. Could you assign this to me? Thank you!"

๋˜๋Š” ๋” ๊ฐ„๋‹จํ•˜๊ฒŒ:
"I'd like to take a look at this. Is it still available?"

์™œ ๋Œ“๊ธ€์„ ๋จผ์ € ๋‹ฌ์•„์•ผ ํ•˜๋ƒ๊ณ ?
โ‘  ์ค‘๋ณต ์ž‘์—… ๋ฐฉ์ง€
โ‘ก ๋ฉ”์ธํ…Œ์ด๋„ˆ์—๊ฒŒ ์ ‘๊ทผ ๋ฐฉ๋ฒ• ํ”ผ๋“œ๋ฐฑ ๋ฐ›์„ ์ˆ˜ ์žˆ์Œ
โ‘ข ์ด์Šˆ๊ฐ€ ์‹ค์ œ๋กœ ์œ ํšจํ•œ์ง€ ํ™•์ธ ๊ฐ€๋Šฅ
โ‘ฃ ์ปค๋ฎค๋‹ˆํ‹ฐ์™€ ์†Œํ†ตํ•˜๋Š” ์ข‹์€ ์‹œ์ž‘์ 
๐Ÿ’ก Tip: ์ด์Šˆ์— ๋Œ“๊ธ€์„ ๋‹ฌ์•˜๋Š”๋ฐ ๋ฉฐ์น ์ด ์ง€๋‚˜๋„ ๋ฐ˜์‘์ด ์—†์œผ๋ฉด,
๊ทธ๋ƒฅ ์ž‘์—…์„ ์‹œ์ž‘ํ•ด๋„ ๊ดœ์ฐฎ์•„. ๋‹จ, 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
๐Ÿ’ก Tip: ํ”„๋กœ์ ํŠธ์— .pre-commit-config.yaml ํŒŒ์ผ์ด ์žˆ์œผ๋ฉด
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์ด ๋จธ์ง€๋  ๊ฐ€๋Šฅ์„ฑ์ด ๋†’์•„์ ธ.

๐Ÿ’ก Tip: PR์„ ๋‚ ๋ฆฌ๊ธฐ ์ „์— ๋กœ์ปฌ์—์„œ ๋จผ์ € ํ…Œ์ŠคํŠธ๋ฅผ ๋Œ๋ ค๋ด.
pytest ๊ฐ€ ํ†ต๊ณผํ•˜๋ฉด CI๋„ ๋Œ€๋ถ€๋ถ„ ํ†ต๊ณผํ•ด.
CI ์‹คํŒจ ํ›„ ์ˆ˜์ •ํ•˜๋Š” ๊ฒƒ๋ณด๋‹ค ๋ฏธ๋ฆฌ ํ™•์ธํ•˜๋Š” ๊ฒŒ ํ›จ์”ฌ ํšจ์œจ์ ์ด์•ผ!

๐Ÿ“ฌ 7. Pull Request ์ž‘์„ฑ: ์ฒซ์ธ์ƒ์ด ์ „๋ถ€๋‹ค

๋“œ๋””์–ด PR์„ ๋‚ ๋ฆด ์‹œ๊ฐ„์ด์•ผ! ๐ŸŽ‰
PR์€ ๋‹จ์ˆœํžˆ ์ฝ”๋“œ๋ฅผ ์˜ฌ๋ฆฌ๋Š” ๊ฒŒ ์•„๋‹ˆ์•ผ.
๋ฉ”์ธํ…Œ์ด๋„ˆ์—๊ฒŒ "๋‚ด๊ฐ€ ์ด๋Ÿฐ ๋ฌธ์ œ๋ฅผ ์ด๋ ‡๊ฒŒ ํ•ด๊ฒฐํ–ˆ์–ด"๋ผ๊ณ  ์„ค๋ช…ํ•˜๋Š” ๊ฑฐ์•ผ.
์ข‹์€ PR์€ ๋ฆฌ๋ทฐ์–ด์˜ ์‹œ๊ฐ„์„ ์•„๊ปด์ฃผ๊ณ , ๋น ๋ฅธ ๋จธ์ง€๋กœ ์ด์–ด์ ธ.

PR ์ œ์ถœ ์ „ ์ตœ์ข… ์ฒดํฌ๋ฆฌ์ŠคํŠธ

โœ… PR ์ œ์ถœ ์ „ ์ฒดํฌ๋ฆฌ์ŠคํŠธ โ–ก ๋ธŒ๋žœ์น˜๊ฐ€ ์ตœ์‹  upstream/main๊ณผ ๋™๊ธฐํ™”๋˜์–ด ์žˆ๋Š”๊ฐ€?
โ–ก ๋ชจ๋“  ํ…Œ์ŠคํŠธ๊ฐ€ ํ†ต๊ณผํ•˜๋Š”๊ฐ€? (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 ์„ค๋ช… ํ…œํ”Œ๋ฆฟ ์˜ˆ์‹œ ## ๋ณ€๊ฒฝ ์‚ฌํ•ญ ์š”์•ฝ (Summary)
์ด 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)
ํ•ด๋‹น ์—†์Œ
๐Ÿ’ก Tip: PR ์ œ๋ชฉ๋„ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€์ฒ˜๋Ÿผ ๋ช…ํ™•ํ•˜๊ฒŒ ์จ์•ผ ํ•ด.
fix: handle float timeout values in parse_timeout ์ฒ˜๋Ÿผ.
"Fix bug" ๊ฐ™์€ ๋ชจํ˜ธํ•œ ์ œ๋ชฉ์€ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ๋ญ˜ ๋ด์•ผ ํ•˜๋Š”์ง€ ๋ชจ๋ฅด๊ฒŒ ํ•ด.

๐Ÿ”„ PR ๋ฆฌ๋ทฐ ์‚ฌ์ดํด ์ดํ•ดํ•˜๊ธฐ PR ์ œ์ถœ CI ์ž๋™ ๊ฒ€์‚ฌ ์ฝ”๋“œ ๋ฆฌ๋ทฐ ์ˆ˜์ • ์š”์ฒญ Merge ๐ŸŽ‰ ์ž๋™ ์‹คํ–‰ ๋ฆฌ๋ทฐ ์š”์ฒญ CI ์‹คํŒจ ์ˆ˜์ • ํ›„ ์žฌ์ œ์ถœ ์Šน์ธ! ๐Ÿ’ก ๋ฆฌ๋ทฐ ํ”ผ๋“œ๋ฐฑ์€ ๊ฐœ์ธ ๊ณต๊ฒฉ์ด ์•„๋‹ˆ์•ผ. ์ฝ”๋“œ๋ฅผ ๋” ์ข‹๊ฒŒ ๋งŒ๋“œ๋Š” ๊ณผ์ •์ด์•ผ! ๊ฒธ์†ํ•˜๊ฒŒ ์ˆ˜์šฉํ•˜์ž.

๐Ÿ’ฌ 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
๐Ÿ’ก Tip: ๋ฆฌ๋ทฐ ํ”ผ๋“œ๋ฐฑ์„ ๋ฐ›๊ณ  ์ˆ˜์ •ํ•˜๋Š” ๊ณผ์ •์—์„œ ์—„์ฒญ๋‚˜๊ฒŒ ๋ฐฐ์šธ ์ˆ˜ ์žˆ์–ด.
๊ฒฝํ—˜ ๋งŽ์€ ๋ฉ”์ธํ…Œ์ด๋„ˆ๋“ค์˜ ์ฝ”๋“œ ๋ฆฌ๋ทฐ๋Š” ์ตœ๊ณ ์˜ ๋ฌด๋ฃŒ ์ฝ”๋“œ ๊ต์œก์ด์•ผ.
ํ”ผ๋“œ๋ฐฑ ํ•˜๋‚˜ํ•˜๋‚˜๋ฅผ ์†Œ์ค‘ํ•˜๊ฒŒ ์—ฌ๊ธฐ๊ณ  ์™œ ๊ทธ๋Ÿฐ ์ง€์ ์„ ํ–ˆ๋Š”์ง€ ์ดํ•ดํ•˜๋ ค๊ณ  ๋…ธ๋ ฅํ•ด๋ด.

๐Ÿ“š 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"

โ‘ข ์ถ”๊ฐ€ ์ •๋ณด ์š”์ฒญ
์ด์Šˆ ๋‚ด์šฉ์ด ๋ถˆ์ถฉ๋ถ„ํ•  ๋•Œ ์žฌํ˜„ ์ฝ”๋“œ, ํ™˜๊ฒฝ ์ •๋ณด ๋“ฑ์„ ์š”์ฒญ.

โ‘ฃ ๋ผ๋ฒจ ์ œ์•ˆ
์ด์Šˆ์— ์ ์ ˆํ•œ ๋ผ๋ฒจ์„ ์ œ์•ˆํ•˜๋Š” ๋Œ“๊ธ€ ๋‹ฌ๊ธฐ.

์ปค๋ฎค๋‹ˆํ‹ฐ ๊ธฐ์—ฌ

๐Ÿค ์ปค๋ฎค๋‹ˆํ‹ฐ ๊ธฐ์—ฌ ๋ฐฉ๋ฒ• โ€ข Stack Overflow ๋‹ต๋ณ€
ํŒŒ์ด์ฌ ๊ด€๋ จ ์งˆ๋ฌธ์— ๋‹ต๋ณ€ํ•˜๊ธฐ. ํƒœ๊ทธ: python, requests, django ๋“ฑ

โ€ข ํฌ๋Ÿผ/Discord ์ฐธ์—ฌ
ํ”„๋กœ์ ํŠธ์˜ ๊ณต์‹ Discord, Slack, ํฌ๋Ÿผ์—์„œ ์งˆ๋ฌธ์— ๋‹ต๋ณ€ํ•˜๊ธฐ

โ€ข ๋ธ”๋กœ๊ทธ ํฌ์ŠคํŠธ ์ž‘์„ฑ
ํ”„๋กœ์ ํŠธ ์‚ฌ์šฉ ๊ฒฝํ—˜, ํŠœํ† ๋ฆฌ์–ผ ์ž‘์„ฑ ํ›„ ๊ณต์œ 

โ€ข ์ปจํผ๋Ÿฐ์Šค ๋ฐœํ‘œ
PyCon, ์ง€์—ญ ํŒŒ์ด์ฌ ๋ฐ‹์—…์—์„œ ํ”„๋กœ์ ํŠธ ์†Œ๊ฐœ ๋ฐœํ‘œ

๐Ÿš€ 10. ์‹ค์ „ ๊ธฐ์—ฌ ์‹œ๋‚˜๋ฆฌ์˜ค: ์ฒ˜์Œ๋ถ€ํ„ฐ ๋๊นŒ์ง€

์ด๋ก ์€ ์ถฉ๋ถ„ํžˆ ๋ฐฐ์› ์œผ๋‹ˆ ์‹ค์ œ ์‹œ๋‚˜๋ฆฌ์˜ค๋กœ ์ „์ฒด ๊ณผ์ •์„ ํ•œ ๋ฒˆ ๋”ฐ๋ผ๊ฐ€๋ณด์ž!
๊ฐ€์ƒ์˜ ํ”„๋กœ์ ํŠธ "awesome-python-utils"์— ๊ธฐ์—ฌํ•˜๋Š” ์ƒํ™ฉ์„ ๊ฐ€์ •ํ• ๊ฒŒ. ๐ŸŽฌ

์‹œ๋‚˜๋ฆฌ์˜ค: ๋ฒ„๊ทธ ์ˆ˜์ • ๊ธฐ์—ฌ

1
์ด์Šˆ ๋ฐœ๊ฒฌ
GitHub์—์„œ label:"good first issue" language:python ๊ฒ€์ƒ‰ ์ค‘
"format_date() returns wrong format for dates before 1970" ์ด์Šˆ ๋ฐœ๊ฒฌ!
๋Œ“๊ธ€์— "I'd like to work on this issue!" ์ž‘์„ฑ.
2
ํ™˜๊ฒฝ ์„ธํŒ…
# 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
3
๋ฒ„๊ทธ ์žฌํ˜„ ๋ฐ ์›์ธ ํŒŒ์•…
# ๋ฒ„๊ทธ ์žฌํ˜„
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๋…„ ์ด์ „ ๋‚ ์งœ๋ฅผ ์ง€์› ์•ˆ ํ•จ
4
๋ธŒ๋žœ์น˜ ์ƒ์„ฑ ๋ฐ ์ˆ˜์ •
git checkout -b fix/format-date-pre-1970

# utils/date.py ์ˆ˜์ •
# timestamp() ๋Œ€์‹  strftime() ์‚ฌ์šฉ์œผ๋กœ ๋ณ€๊ฒฝ
5
ํ…Œ์ŠคํŠธ ์ž‘์„ฑ ๋ฐ ์‹คํ–‰
# 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
# ๋ชจ๋“  ํ…Œ์ŠคํŠธ ํ†ต๊ณผ ํ™•์ธ!
6
์ปค๋ฐ‹ ๋ฐ Push
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
7
PR ์ƒ์„ฑ
GitHub์—์„œ PR ์ƒ์„ฑ ๋ฒ„ํŠผ ํด๋ฆญ ํ›„ ์„ค๋ช… ์ž‘์„ฑ.
CI๊ฐ€ ์ž๋™์œผ๋กœ ์‹คํ–‰๋˜๊ณ  ์ดˆ๋ก๋ถˆ ํ™•์ธ! โœ…
8
๋ฆฌ๋ทฐ ๋Œ€์‘
๋ฉ”์ธํ…Œ์ด๋„ˆ: "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! ๐ŸŽ‰
๐ŸŽŠ ์ถ•ํ•˜ํ•ด! ์ฒซ ๋ฒˆ์งธ ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ ์™„๋ฃŒ! ์ด์ œ GitHub ํ”„๋กœํ•„์— ๊ธฐ์—ฌ ์ด๋ ฅ์ด ์ƒ๊ฒผ์–ด.
์ž‘์€ ๋ฒ„๊ทธ ์ˆ˜์ • ํ•˜๋‚˜์ง€๋งŒ, ์ด๊ฒŒ ์Œ“์ด๋ฉด ์—„์ฒญ๋‚œ ํฌํŠธํด๋ฆฌ์˜ค๊ฐ€ ๋ผ.
๊ทธ๋ฆฌ๊ณ  ๋ฌด์—‡๋ณด๋‹ค, ์ „ ์„ธ๊ณ„ ์ˆ˜๋งŽ์€ ์‚ฌ๋žŒ๋“ค์ด ์“ฐ๋Š” ์ฝ”๋“œ๋ฅผ ๊ฐœ์„ ํ–ˆ๋‹ค๋Š” ๋ฟŒ๋“ฏํ•จ! ๐ŸŒ

โšก 11. ์ž์ฃผ ํ•˜๋Š” ์‹ค์ˆ˜์™€ ํ•ด๊ฒฐ๋ฒ•

์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ๋ฅผ ์ฒ˜์Œ ํ•˜๋ฉด ๋ˆ„๊ตฌ๋‚˜ ์‹ค์ˆ˜๋ฅผ ํ•ด.
๋ฏธ๋ฆฌ ์•Œ์•„๋‘๋ฉด ์‹œํ–‰์ฐฉ์˜ค๋ฅผ ์ค„์ผ ์ˆ˜ ์žˆ์–ด! ๐Ÿ›ก๏ธ

์‹ค์ˆ˜ 1: main ๋ธŒ๋žœ์น˜์—์„œ ์ง์ ‘ ์ž‘์—…

โŒ ๋ฌธ์ œ: 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์— ์—ฌ๋Ÿฌ ๊ธฐ๋Šฅ/๋ฒ„๊ทธ ์ˆ˜์ •์„ ๋ชฐ์•„๋„ฃ์Œ

โœ… ํ•ด๊ฒฐ:
ํ•˜๋‚˜์˜ 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. ๋” ๊นŠ์ด ๋“ค์–ด๊ฐ€๊ธฐ: ๋ฉ”์ธํ…Œ์ด๋„ˆ๊ฐ€ ๋˜๋Š” ๊ธธ

๊ธฐ์—ฌ๋ฅผ ๊พธ์ค€ํžˆ ํ•˜๋‹ค ๋ณด๋ฉด ์–ด๋А ์ˆœ๊ฐ„ ๋ฉ”์ธํ…Œ์ด๋„ˆ ์ œ์•ˆ์„ ๋ฐ›์„ ์ˆ˜ ์žˆ์–ด.
๋˜๋Š” ์ง์ ‘ ์˜คํ”ˆ์†Œ์Šค ํ”„๋กœ์ ํŠธ๋ฅผ ์‹œ์ž‘ํ•  ์ˆ˜๋„ ์žˆ์ง€.
๋” ๊นŠ์€ ์ฐธ์—ฌ๋ฅผ ์œ„ํ•œ ๋ฐฉ๋ฒ•๋“ค์„ ์•Œ์•„๋ณด์ž! ๐Ÿ†

๊พธ์ค€ํ•œ ๊ธฐ์—ฌ์ž๊ฐ€ ๋˜๋Š” ๋ฐฉ๋ฒ•

๐Ÿ“ˆ ๊ธฐ์—ฌ ๋ ˆ๋ฒจ์—… ์ „๋žต ๋ ˆ๋ฒจ 1: ์ฒซ ๊ธฐ์—ฌ (๋ฌธ์„œ/์˜คํƒ€ ์ˆ˜์ •)
โ†’ ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ ํŒŒ์•…, Git ์›Œํฌํ”Œ๋กœ์šฐ ์ตํžˆ๊ธฐ

๋ ˆ๋ฒจ 2: ๋ฒ„๊ทธ ์ˆ˜์ • ๊ธฐ์—ฌ
โ†’ ์ฝ”๋“œ๋ฒ ์ด์Šค ์ดํ•ด, ํ…Œ์ŠคํŠธ ์ž‘์„ฑ ๋Šฅ๋ ฅ

๋ ˆ๋ฒจ 3: ์ƒˆ ๊ธฐ๋Šฅ ๊ธฐ์—ฌ
โ†’ ์„ค๊ณ„ ํ† ๋ก  ์ฐธ์—ฌ, ํฐ ๊ทธ๋ฆผ ์ดํ•ด

๋ ˆ๋ฒจ 4: ์ฝ”๋“œ ๋ฆฌ๋ทฐ์–ด
โ†’ ๋‹ค๋ฅธ ์‚ฌ๋žŒ์˜ PR ๋ฆฌ๋ทฐ, ์ด์Šˆ ํŠธ๋ฆฌ์•„์ง€

๋ ˆ๋ฒจ 5: ๋ฉ”์ธํ…Œ์ด๋„ˆ
โ†’ ํ”„๋กœ์ ํŠธ ๋ฐฉํ–ฅ ๊ฒฐ์ •, ๋ฆด๋ฆฌ์ฆˆ ๊ด€๋ฆฌ

Google Summer of Code (GSoC) ์ฐธ์—ฌ

GSoC๋Š” ๊ตฌ๊ธ€์ด ํ›„์›ํ•˜๋Š” ์˜คํ”ˆ์†Œ์Šค ๋ฉ˜ํ† ๋ง ํ”„๋กœ๊ทธ๋žจ์ด์•ผ.
๋งค๋…„ ํŒŒ์ด์ฌ ๊ด€๋ จ ํ”„๋กœ์ ํŠธ๋“ค์ด ์ฐธ์—ฌํ•˜๊ณ , ํ•™์ƒ๋“ค์—๊ฒŒ ์Šคํ‹ฐํŽœ๋“œ(์žฅํ•™๊ธˆ)๋„ ์ค˜.
์ฐธ์—ฌ ๋ฐฉ๋ฒ•:

1
1~2์›”: ๊ด€์‹ฌ ์žˆ๋Š” ์กฐ์ง์˜ ํ”„๋กœ์ ํŠธ์— ๋ฏธ๋ฆฌ ๊ธฐ์—ฌ ์‹œ์ž‘
2
3์›”: GSoC ์กฐ์ง ๋ฐœํ‘œ ํ›„ ๊ด€์‹ฌ ์กฐ์ง์— ์—ฐ๋ฝ
3
4์›”: ํ”„๋กœ์ ํŠธ ์ œ์•ˆ์„œ ์ž‘์„ฑ ๋ฐ ์ œ์ถœ
4
5~8์›”: ์„ ๋ฐœ ์‹œ ๋ฉ˜ํ† ์™€ ํ•จ๊ป˜ ํ”„๋กœ์ ํŠธ ์ง„ํ–‰

๋‚˜๋งŒ์˜ ์˜คํ”ˆ์†Œ์Šค ํ”„๋กœ์ ํŠธ ์‹œ์ž‘ํ•˜๊ธฐ

๊ธฐ์—ฌ ๊ฒฝํ—˜์ด ์Œ“์ด๋ฉด ์ง์ ‘ ํ”„๋กœ์ ํŠธ๋ฅผ ์‹œ์ž‘ํ•  ์ˆ˜๋„ ์žˆ์–ด.
์žฌ๋Šฅ๋„ท์—์„œ ํŒŒ์ด์ฌ ๊ด€๋ จ ์žฌ๋Šฅ์„ ๊ณต์œ ํ•˜๋Š” ๋ถ„๋“ค์ด๋ผ๋ฉด,
์ž์‹ ์˜ ๋„๊ตฌ๋ฅผ ์˜คํ”ˆ์†Œ์Šค๋กœ ๊ณต๊ฐœํ•˜๋Š” ๊ฒƒ๋„ ํ›Œ๋ฅญํ•œ ๋ฐฉ๋ฒ•์ด์•ผ! ๐ŸŒฑ

๐Ÿš€ ์˜คํ”ˆ์†Œ์Šค ํ”„๋กœ์ ํŠธ ์‹œ์ž‘ ์ฒดํฌ๋ฆฌ์ŠคํŠธ โ–ก README.md - ํ”„๋กœ์ ํŠธ ์„ค๋ช…, ์„ค์น˜ ๋ฐฉ๋ฒ•, ์‚ฌ์šฉ ์˜ˆ์‹œ
โ–ก 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 ์œ ์šฉํ•œ ํ™•์žฅ ํ”„๋กœ๊ทธ๋žจ

๐Ÿ”Œ ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ์— ์œ ์šฉํ•œ VS Code ํ™•์žฅ โ€ข Python - ํŒŒ์ด์ฌ ๊ธฐ๋ณธ ์ง€์›
โ€ข Pylance - ํƒ€์ž… ์ฒดํฌ, ์ž๋™์™„์„ฑ
โ€ข GitLens - Git ํžˆ์Šคํ† ๋ฆฌ ์‹œ๊ฐํ™”
โ€ข GitHub Pull Requests - VS Code์—์„œ PR ๋ฆฌ๋ทฐ
โ€ข Black Formatter - Black ์ž๋™ ํฌ๋งท
โ€ข Ruff - ๋น ๋ฅธ ๋ฆฐํŒ…
โ€ข Python Test Explorer - ํ…Œ์ŠคํŠธ ์‹œ๊ฐํ™”
โ€ข Todo Tree - TODO ์ฃผ์„ ์ถ”์ 

๐Ÿ ํŒŒ์ด์ฌ ์˜คํ”ˆ์†Œ์Šค ์ƒํƒœ๊ณ„ ์ง€๋„ Python CPython ์›น ํ”„๋ ˆ์ž„์›Œํฌ Django, Flask FastAPI ๋ฐ์ดํ„ฐ ๊ณผํ•™ NumPy, Pandas Scikit-learn ๊ฐœ๋ฐœ ๋„๊ตฌ pip, Poetry pytest, Black AI / ML PyTorch TensorFlow ์ž๋™ํ™” Ansible, Fabric Celery HTTP/๋„คํŠธ์›Œํฌ Requests httpx, aiohttp ๋ชจ๋“  ํ”„๋กœ์ ํŠธ๊ฐ€ ๊ธฐ์—ฌ๋ฅผ ๊ธฐ๋‹ค๋ฆฌ๊ณ  ์žˆ์–ด! ๐Ÿš€

๐Ÿ’ก 14. ์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ Q&A: ์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ๋“ค

์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ๋ฅผ ์‹œ์ž‘ํ•˜๋ ค๋Š” ์‚ฌ๋žŒ๋“ค์ด ์ž์ฃผ ํ•˜๋Š” ์งˆ๋ฌธ๋“ค์„ ๋ชจ์•„๋ดค์–ด.
ํ˜น์‹œ ์ด๋Ÿฐ ๊ณ ๋ฏผ ํ•˜๊ณ  ์žˆ์—ˆ์–ด? ๐Ÿ˜Š

Q1. ์˜์–ด๋ฅผ ์ž˜ ๋ชปํ•˜๋Š”๋ฐ ๊ธฐ์—ฌํ•  ์ˆ˜ ์žˆ๋‚˜์š”? A: ๋ฌผ๋ก ์ด์•ผ! ๊ธฐ๋ณธ์ ์ธ ์˜์–ด ํ‘œํ˜„๋งŒ ์•Œ์•„๋„ ์ถฉ๋ถ„ํ•ด.
"I'd like to work on this issue." "Fixed!" "Thank you for the review!"
์ด ์ •๋„๋ฉด ์ถฉ๋ถ„ํ•ด. ๊ตฌ๊ธ€ ๋ฒˆ์—ญ์ด๋‚˜ ChatGPT๋ฅผ ํ™œ์šฉํ•ด๋„ ๋ผ.
๊ทธ๋ฆฌ๊ณ  ํ•œ๊ตญ์–ด ๋ฌธ์„œ ๋ฒˆ์—ญ ํ”„๋กœ์ ํŠธ์— ๊ธฐ์—ฌํ•˜๋ฉด ํ•œ๊ตญ์–ด๋กœ ๊ธฐ์—ฌํ•  ์ˆ˜๋„ ์žˆ์–ด!
Q2. ์‹ค๋ ฅ์ด ๋ถ€์กฑํ•œ๋ฐ ๊ธฐ์—ฌํ•ด๋„ ๋ ๊นŒ์š”? A: ๋‹น์—ฐํ•˜์ง€! ์˜คํ”ˆ์†Œ์Šค๋Š” ๋ฐฐ์šฐ๋ฉด์„œ ๊ธฐ์—ฌํ•˜๋Š” ๊ณณ์ด์•ผ.
์˜คํƒ€ ์ˆ˜์ •, ๋ฌธ์„œ ๊ฐœ์„ ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด๋ด. ์ฝ”๋“œ ์‹ค๋ ฅ์ด ์—†์–ด๋„ ํ•  ์ˆ˜ ์žˆ๋Š” ์ผ์ด ๋งŽ์•„.
๊ทธ๋ฆฌ๊ณ  ์ฝ”๋“œ ๋ฆฌ๋ทฐ๋ฅผ ๋ฐ›์œผ๋ฉด์„œ ์‹ค๋ ฅ์ด ๋น ๋ฅด๊ฒŒ ๋Š˜์–ด. ์‹ค๋ ฅ์ด ๋ถ€์กฑํ•˜๋‹ค๊ณ  ๋А๋‚„์ˆ˜๋ก ๋” ๊ธฐ์—ฌํ•ด์•ผ ํ•ด!
Q3. PR์ด ๊ฑฐ์ ˆ๋‹นํ•˜๋ฉด ์–ด๋–ป๊ฒŒ ํ•˜๋‚˜์š”? A: ๊ฑฐ์ ˆ์€ ์‹คํŒจ๊ฐ€ ์•„๋‹ˆ์•ผ. ๋ฐฐ์›€์˜ ๊ธฐํšŒ์•ผ.
์™œ ๊ฑฐ์ ˆ๋๋Š”์ง€ ์ด์œ ๋ฅผ ์ž˜ ์ฝ๊ณ , ๊ฐœ์„ ํ•ด์„œ ๋‹ค์‹œ ๋„์ „ํ•˜๊ฑฐ๋‚˜
๋‹ค๋ฅธ ์ด์Šˆ์— ๋„์ „ํ•ด๋ด. ์ฒ˜์Œ์—๋Š” ๊ฑฐ์ ˆ๋‹นํ•˜๋Š” ๊ฒŒ ๋‹น์—ฐํ•ด.
์œ ๋ช…ํ•œ ์ปจํŠธ๋ฆฌ๋ทฐํ„ฐ๋“ค๋„ ์ฒ˜์Œ์—” PR์ด ๊ฑฐ์ ˆ๋์–ด.
Q4. ์–ผ๋งˆ๋‚˜ ์ž์ฃผ ๊ธฐ์—ฌํ•ด์•ผ ํ•˜๋‚˜์š”? A: ์ •ํ•ด์ง„ ๊ธฐ์ค€์€ ์—†์–ด. ์ผ์ฃผ์ผ์— ํ•œ ๋ฒˆ์ด๋“ , ํ•œ ๋‹ฌ์— ํ•œ ๋ฒˆ์ด๋“  ๊ดœ์ฐฎ์•„.
๊พธ์ค€ํ•จ์ด ์ค‘์š”ํ•ด. ํ•œ ๋ฒˆ์— ์—„์ฒญ๋‚œ ๊ธฐ์—ฌ๋ฅผ ํ•˜๋Š” ๊ฒƒ๋ณด๋‹ค
์ž‘์€ ๊ธฐ์—ฌ๋ฅผ ๊พธ์ค€ํžˆ ํ•˜๋Š” ๊ฒŒ ๋” ์ข‹์€ ํ‰ํŒ์„ ๋งŒ๋“ค์–ด.
Q5. ๊ธฐ์—ฌํ•œ ์ฝ”๋“œ์˜ ์ €์ž‘๊ถŒ์€ ๋ˆ„๊ตฌ ๊ฒƒ์ธ๊ฐ€์š”? A: ๋Œ€๋ถ€๋ถ„์˜ ์˜คํ”ˆ์†Œ์Šค ํ”„๋กœ์ ํŠธ๋Š” CLA(Contributor License Agreement)๋ฅผ ์š”๊ตฌํ•ด.
CLA์— ์„œ๋ช…ํ•˜๋ฉด ์ €์ž‘๊ถŒ์€ ๋ณธ์ธ์ด ์œ ์ง€ํ•˜๋˜, ํ”„๋กœ์ ํŠธ์— ์‚ฌ์šฉ ๊ถŒํ•œ์„ ๋ถ€์—ฌํ•˜๋Š” ๊ฑฐ์•ผ.
์ผ๋ถ€ ํ”„๋กœ์ ํŠธ๋Š” ์ €์ž‘๊ถŒ์„ ์žฌ๋‹จ์— ์–‘๋„ํ•˜๊ธฐ๋„ ํ•ด (์˜ˆ: PSF).
๊ธฐ์—ฌ ์ „์— CONTRIBUTING.md์—์„œ CLA ๊ด€๋ จ ๋‚ด์šฉ์„ ํ™•์ธํ•ด๋ด.
Q6. ๊ธฐ์—ฌ ์ด๋ ฅ์„ ์ด๋ ฅ์„œ์— ์–ด๋–ป๊ฒŒ ์“ฐ๋‚˜์š”? A: ์ด๋ ‡๊ฒŒ ์จ๋ด:
"Contributed to [ํ”„๋กœ์ ํŠธ๋ช…] (GitHub Stars: X,XXX): Fixed [๋ฒ„๊ทธ ์„ค๋ช…], added [๊ธฐ๋Šฅ ์„ค๋ช…]"
GitHub ํ”„๋กœํ•„ ๋งํฌ๋„ ํ•จ๊ป˜ ์ฒจ๋ถ€ํ•ด. ๋ฉด์ ‘๊ด€์ด ์ง์ ‘ ํ™•์ธํ•  ์ˆ˜ ์žˆ์–ด.
ํŠนํžˆ ์œ ๋ช…ํ•œ ํ”„๋กœ์ ํŠธ์— ๊ธฐ์—ฌํ–ˆ๋‹ค๋ฉด ๋”์šฑ ๊ฐ•์กฐํ•ด๋ด.

๐ŸŽฏ 15. ์˜ค๋Š˜ ๋‹น์žฅ ์‹œ์ž‘ํ•˜๋Š” ์•ก์…˜ ํ”Œ๋žœ

์ž, ์ด์ œ ์ถฉ๋ถ„ํžˆ ๋ฐฐ์› ์–ด. ์ด๋ก ์€ ๊ทธ๋งŒํ•˜๊ณ  ์‹ค์ „์œผ๋กœ ๊ฐ€์ž!
์˜ค๋Š˜ ๋‹น์žฅ ํ•  ์ˆ˜ ์žˆ๋Š” ๊ฒƒ๋“ค์„ ๋‹จ๊ณ„๋ณ„๋กœ ์ •๋ฆฌํ•ด์ค„๊ฒŒ. ๐Ÿƒโ€โ™‚๏ธ

1
์ง€๊ธˆ ๋‹น์žฅ (30๋ถ„ ์ด๋‚ด)
โ€ข GitHub ๊ณ„์ • ๋งŒ๋“ค๊ธฐ (์—†๋‹ค๋ฉด)
โ€ข ํ‰์†Œ์— ์ž์ฃผ ์“ฐ๋Š” ํŒŒ์ด์ฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ GitHub ํŽ˜์ด์ง€ ๋ฐฉ๋ฌธ
โ€ข Issues ํƒญ์—์„œ good first issue ๋ผ๋ฒจ ์ด์Šˆ 3๊ฐœ ์ฐพ๊ธฐ
2
์˜ค๋Š˜ (2~3์‹œ๊ฐ„)
โ€ข ๋งˆ์Œ์— ๋“œ๋Š” ์ด์Šˆ ํ•˜๋‚˜ ์„ ํƒ
โ€ข ๋ ˆํฌ Fork ๋ฐ Clone
โ€ข ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ธํŒ… (venv, ์˜์กด์„ฑ ์„ค์น˜)
โ€ข CONTRIBUTING.md ์ฝ๊ธฐ
3
์ด๋ฒˆ ์ฃผ (5~10์‹œ๊ฐ„)
โ€ข ์ด์Šˆ ๋Œ“๊ธ€๋กœ ์ž‘์—… ์˜์‚ฌ ํ‘œ๋ช…
โ€ข ์ฝ”๋“œ ์ˆ˜์ • ๋ฐ ํ…Œ์ŠคํŠธ ์ž‘์„ฑ
โ€ข ์ฒซ ๋ฒˆ์งธ PR ์ œ์ถœ!
4
์ด๋ฒˆ ๋‹ฌ
โ€ข ๋ฆฌ๋ทฐ ํ”ผ๋“œ๋ฐฑ ๋ฐ˜์˜
โ€ข ์ฒซ ๋ฒˆ์งธ PR Merge ๋‹ฌ์„ฑ ๐ŸŽ‰
โ€ข ๋‘ ๋ฒˆ์งธ ์ด์Šˆ ๋„์ „
5
3๊ฐœ์›” ํ›„
โ€ข 5๊ฐœ ์ด์ƒ์˜ ๊ธฐ์—ฌ ์ด๋ ฅ
โ€ข ์ฝ”๋“œ ๋ฆฌ๋ทฐ์–ด๋กœ ์ฐธ์—ฌ
โ€ข ๋” ๋ณต์žกํ•œ ์ด์Šˆ ๋„์ „
"The best time to plant a tree was 20 years ago. The second best time is now."
์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ๋„ ๋งˆ์ฐฌ๊ฐ€์ง€์•ผ. ์ง€๊ธˆ ์‹œ์ž‘ํ•˜๋Š” ๊ฒŒ ์ตœ์„ ์ด์•ผ. ๐ŸŒณ
๐Ÿ’ก ๋งˆ์ง€๋ง‰ ํŒ: ์ฒซ ๊ธฐ์—ฌ๊ฐ€ ์™„์„ฑ๋˜๋ฉด ๊ผญ ๊ธฐ๋กํ•ด๋‘ฌ.
๋ธ”๋กœ๊ทธ์— ํ›„๊ธฐ๋ฅผ ์“ฐ๊ฑฐ๋‚˜, ์žฌ๋Šฅ๋„ท ๊ฐ™์€ ํ”Œ๋žซํผ์—์„œ ๊ฒฝํ—˜์„ ๊ณต์œ ํ•ด๋ด.
๋‹ค๋ฅธ ์‚ฌ๋žŒ๋“ค์—๊ฒŒ ์˜๊ฐ์„ ์ฃผ๋Š” ๊ฒƒ๋„ ํ›Œ๋ฅญํ•œ ๊ธฐ์—ฌ์•ผ! โœจ

๐ŸŽŠ ๋งˆ๋ฌด๋ฆฌ: ์˜คํ”ˆ์†Œ์Šค๋Š” ํ•จ๊ป˜ ๋งŒ๋“œ๋Š” ๊ฒƒ

์—ฌ๊ธฐ๊นŒ์ง€ ์ฝ์–ด์ค˜์„œ ๊ณ ๋งˆ์›Œ! ์ •๋ง ๊ธด ์—ฌ์ •์ด์—ˆ์ง€? ๐Ÿ˜„

์˜คํ”ˆ์†Œ์Šค ๊ธฐ์—ฌ๋Š” ๋‹จ์ˆœํžˆ ์ฝ”๋“œ๋ฅผ ์˜ฌ๋ฆฌ๋Š” ๊ฒŒ ์•„๋‹ˆ์•ผ.
์ „ ์„ธ๊ณ„ ๊ฐœ๋ฐœ์ž๋“ค๊ณผ ํ•จ๊ป˜ ๋” ๋‚˜์€ ์†Œํ”„ํŠธ์›จ์–ด๋ฅผ ๋งŒ๋“œ๋Š” ๊ณผ์ •์ด์•ผ.
๋‚ด๊ฐ€ ๊ณ ์นœ ๋ฒ„๊ทธ ํ•˜๋‚˜๊ฐ€ ์ˆ˜๋ฐฑ๋งŒ ๋ช…์˜ ๊ฐœ๋ฐœ์ž์—๊ฒŒ ๋„์›€์ด ๋  ์ˆ˜ ์žˆ์–ด.
๊ทธ ๋ฟŒ๋“ฏํ•จ์€ ๊ฒฝํ—˜ํ•ด๋ณธ ์‚ฌ๋žŒ๋งŒ ์•Œ์•„. ๐ŸŒ

ํŒŒ์ด์ฌ ์ƒํƒœ๊ณ„๋Š” ์ •๋ง ๋”ฐ๋œปํ•œ ์ปค๋ฎค๋‹ˆํ‹ฐ์•ผ.
์‹ค์ˆ˜ํ•ด๋„ ๊ดœ์ฐฎ๊ณ , ์งˆ๋ฌธํ•ด๋„ ๊ดœ์ฐฎ์•„.
๋ชจ๋‘๊ฐ€ ์ฒ˜์Œ์—” ์ดˆ๋ณด์ž์˜€๊ฑฐ๋“ .

์˜ค๋Š˜ ์ฒซ ๋ฒˆ์งธ ์ด์Šˆ๋ฅผ ์ฐพ์•„๋ด. ๊ทธ๊ฒŒ ์‹œ์ž‘์ด์•ผ.

ํ™”์ดํŒ…! ๐Ÿ๐Ÿš€

๋Œ“๊ธ€ ์ž‘์„ฑ

์ด ๊ธ€์— ๋Œ€ํ•œ ์—ฌ๋Ÿฌ๋ถ„์˜ ์ƒ๊ฐ์„ ๋“ค๋ ค์ฃผ์„ธ์š”

๋Œ“๊ธ€ 0
๋Œ“๊ธ€์„ ๋ถˆ๋Ÿฌ์˜ค๋Š” ์ค‘์ž…๋‹ˆ๋‹ค.

์•„์ง ๋Œ“๊ธ€์ด ์—†์Šต๋‹ˆ๋‹ค.