Task 리스트 — 진짜로 commit 되는 체크박스

GitHub 가 진지하게 다루는 체크박스 리스트

GFM task 리스트는 [ ] (미완료) 또는 [x] (완료) 로 시작하는 unordered list 항목. 대괄호는 list 마커 바로 뒤, 공백 한 칸 두고 와야 해.

GitHub 에서 달라지는 것

issue, PR, discussion 에서 task 리스트 항목은 인터랙티브 체크박스 로 렌더링돼. write 권한 있는 누구나 토글 가능. 토글 한 번이 issue 본문에 진짜 edit 으로 박혀 — issue 의 edit history 에 audit trail 이 남아.

GitHub 는 PR description 의 task 리스트로 완료율 도 계산해. PR 리스트 뷰에 제목 옆에 '3 / 8' 표시. 무료 progress bar.

Task 중첩

일반 리스트 중첩처럼: 2 칸 단위. 중첩 task 는 중첩 체크박스로 렌더링. 부모와 자식은 독립 — 부모 토글해도 자식 자동 토글 안 돼.

원칙: issue 안의 task 리스트는 팀과의 계약. 각 박스는 검증 가능한 atomic step. '성능 개선' 같은 모호한 항목은 체크박스 자격 없음. '`users.email` 에 인덱스 추가' 같은 구체적인 건 자격 있어.

Code

기본 task 리스트·markdown

- [ ] Read the spec
- [x] Sketch the schema
- [ ] Write the migration
- [ ] Add tests

중첩 task (서브스텝)·markdown

- [ ] Ship release v2
  - [x] Tag the commit
  - [x] Update CHANGELOG
  - [ ] Push the tag
  - [ ] Announce in #general

일반 bullet 와 섞기·markdown

- Notes (no checkbox, just context)
- [ ] Action: file the bug
- [ ] Action: run the migration
- Owner: @cwk

Task 리스트 — 진짜로 commit 되는 체크박스

GitHub 가 진지하게 다루는 체크박스 리스트

GitHub 에서 달라지는 것

Task 중첩

Code

External links

Exercise

Progress

댓글 0