[DOC] Git Rules & Conventions - boostcamp-2020/Project18-A-Boostagram GitHub Wiki

Git Rules & Conventions ๐Ÿ’ป

Commit โœ”๏ธ

Commit Rules

  • ์ปค๋ฐ‹ ์ œ๋ชฉ ํ˜•์‹์€ type: title
    • ์˜ˆ: 'feat: ๋กœ๊ทธ์ธ ๊ธฐ๋Šฅ ๊ตฌํ˜„'
  • ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€ ๋ณธ๋ฌธ์€ ์ตœ๋Œ€ํ•œ ๊ตฌ์ฒด์ ์œผ๋กœ ์ž‘์„ฑ
    • ์ปค๋ฐ‹์— ํฌํ•จ๋˜๋Š” ํŒŒ์ผ์„ ๋ช…์‹œํ•˜๊ณ  ํ•ด๋‹น ํŒŒ์ผ์— ๋Œ€ํ•œ ๊ฐœ๋ฐœ ๋‚ด์šฉ์„ ์„ค๋ช…

Commit Prefix

type description
feat ๊ธฐ๋Šฅ ์ถ”๊ฐ€
fix ๋ฒ„๊ทธ ์ˆ˜์ •
docs ๋ฌธ์„œ ์ž‘์„ฑ
refactor ์ฝ”๋“œ ์ˆ˜์ •
chore ๋นŒ๋“œ ์—…๋ฌด ์ˆ˜์ •, ํŒจํ‚ค์ง€ ์ถ”๊ฐ€ ๋“ฑ
style css, ์ฝ”๋”ฉ ์Šคํƒ€์ผ(ํ˜•์‹, ์ •๋ ฌ, ์ฃผ์„)
update ์œ„์˜ ์‚ฌํ•ญ๋“ค์— ํฌํ•จ๋˜์ง€ ์•Š๋Š” ๋ณ€๊ฒฝ์‚ฌํ•ญ๋“ค

Branches ๐ŸŽ‹

master

๋ฐฐํฌ ๊ฐ€๋Šฅํ•œ ๋ฒ„์ „์˜ ์ฝ”๋“œ๊ฐ€ ์žˆ๋Š” ๋ธŒ๋žœ์น˜

  • ๋ธŒ๋žœ์น˜๋Š” ํ•ญ์ƒ ์ตœ์‹ ์˜ ์ƒํƒœ์ด๋ฉฐ, stable ์ƒํƒœ๋กœ Product์— ๋ฐฐํฌ๋˜๋Š” ๋ธŒ๋žœ์น˜์ด๋‹ค

develop

๊ธฐ๋Šฅ์ด ๋™์ž‘ํ•˜๋Š” ์ƒํƒœ

  • feature ๋‹จ์œ„์˜ ๋ธŒ๋žœ์น˜๋“ค์ด merge๋˜๋Š” ๋ธŒ๋žœ์น˜

feature

๊ธฐ๋Šฅ ๊ฐœ๋ฐœ์„ ์œ„ํ•œ ๋ธŒ๋žœ์น˜

  • ๋ธŒ๋žœ์น˜ ๋‚˜์˜ค๋Š” ๊ณณ : develop
  • ๋ธŒ๋žœ์น˜๊ฐ€ ๋“ค์–ด๊ฐ€๋Š” ๊ณณ : develop
  • ์ด๋ฆ„ ์ง€์ • : master, develop์„ ์ œ์™ธํ•œ ์–ด๋–ค ๊ฒƒ์ด๋“  ๊ฐ€๋Šฅ.
  • ์˜ˆ: feat/login-be, feat/login-fe ...

hotfix

์ˆ˜์ •ํ•ด์•ผ ํ•  ๋ถ€๋ถ„

  • ์˜ˆ: hotfix/modify_attr

Pull Request ๐Ÿค

PR Rules

  • PR ๋‹จ์œ„ : issue 1๊ฐœ = backlog์˜ task 1๊ฐœ
  • ๊ธฐ๋ณธ ์›์น™ : ์ €๋…์— ๊ฐ์ž ์ฝ”๋“œ๋ฆฌ๋ทฐ ํ›„, ๋‹ค์Œ ๋‚  ์Šคํฌ๋Ÿผ ๋•Œ ๋จธ์ง€
  • ๊ธด๊ธ‰ PR : PR ์ž‘์„ฑ ํ›„ ์Šฌ๋ž™์ด๋‚˜ ์คŒ์„ ํ†ตํ•ด ๋จธ์ง€ ์š”์ฒญ -> ๋ฐ”๋กœ ์ฝ”๋“œ๋ฆฌ๋ทฐ ํ›„ ๋จธ์ง€
  • ๋ณ„๋„์˜ ํ•ด์„ค์ด ์—†๋Š” ๋Œ€์‹ , ์ปค๋ฐ‹ ๋ฉ”์„ธ์ง€์™€ PR ๋‚ด์šฉ์„ ์ž์„ธํžˆ ์ž‘์„ฑํ•  ๊ฒƒ

PR Conventions

  • ์ œ๋ชฉ
    • #[issue] - title (์ด์Šˆ ์ด๋ฆ„)
  • ๋ณธ๋ฌธ
    • ๊ตฌํ˜„ ๋‚ด์šฉ
    • ์ด๋ฏธ์ง€ (์˜ต์…˜)
    • ์ตœ๋Œ€ํ•œ ์ž์„ธํžˆ ์ž‘์„ฑ

[ํ† ๋ก ] PR ๋ฆฌ๋ทฐ๋Š” ์–ด๋–ป๊ฒŒ ํ•  ๊ฒƒ์ธ๊ฐ€?

  1. ํ•˜๋ฃจ ๋‹จ์œ„๋กœ ์ฒ˜๋ฆฌ
    • ์žฅ์  : ์ฝ”์–ดํƒ€์ž„ ๋‚ด์—๋Š” ๊ฐœ๋ฐœ์—๋งŒ ์ง‘์ค‘ํ•  ์ˆ˜ ์žˆ๋‹ค.
    • ๋‹จ์  : ์ด์ „ pr์˜ ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•ด์•ผ ํ•  ๋•Œ, ๋จธ์ง€๊ฐ€ ๋˜์ง€์•Š์•„ ๋‹ค์Œ ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ์— ๋ฌธ์ œ๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ๋‹ค.
  2. ๊ทธ๋•Œ ๊ทธ๋•Œ ์ฒ˜๋ฆฌ
    • ์žฅ์  : ๋ธŒ๋žœ์น˜ ๊ด€๋ฆฌ๊ฐ€ ํŽธํ•˜๋‹ค. pr ์š”์ฒญ ํ›„, merge ์ „ ์ž‘์—…์„ ์ด์–ด๋‚˜๊ฐ€๋Š” ๊ฒƒ์ด ์• ๋งคํ–ˆ๋Š”๋ฐ ๋น ๋ฅธ merge ์ดํ›„ ์ด์–ด๋‚˜๊ฐ€๊ธฐ ์šฉ์ดํ•ด์ง
    • ๋‹จ์  : ๋งค ๋ฒˆ ์ฆ‰๊ฐ์ ์œผ๋กœ ์ฝ”๋“œ ๋ฆฌ๋ทฐ ๋ฐ ์Šน์ธ์„ ํ•ด์ค„ ์‚ฌ๋žŒ์ด ํ•„์š”ํ•˜๋‹ค. ๋ฆฌ๋ทฐ์–ด์˜ ์ž‘์—… ํ๋ฆ„์ด ๋Š๊ธฐ๊ธฐ ์‰ฌ์›€
  3. [๊ฒฐ๋ก ] ํ•˜๋ฃจ ๋‹จ์œ„๋กœ ํ•˜๋˜, ๊ธด๊ธ‰ ์ƒํ™ฉ์‹œ zoom์„ ํ†ตํ•ด ๊ณต์ง€ํ•˜์—ฌ ์ตœ๋Œ€ํ•œ ๋น ๋ฅด๊ฒŒ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•œ๋‹ค.