GitHub Issues နှင့် Project Tracking

နားလည်ထားရမယ့် အချက်

Issue ဆိုတာ code မဟုတ်သေးပေမယ့် အာရုံစိုက်ရန်လိုအပ်တဲ့ မည်သည့်အရာအတွက်မဆို GitHub ရဲ့ tracking unit ပါ — bug report, feature request, task, ဒါမှမဟုတ် open discussion တစ်ခု ဖြစ်နိုင်ပါတယ်။

Pull request နှင့် မတူဘဲ issue တစ်ခုမှာ branch ဒါမှမဟုတ် commit လုံးဝ မပါဝင်ပါဘူး — title, description, open/closed status ပါတဲ့ discussion thread တစ်ခုပဲ ဖြစ်ပေမယ့် GitHub က ၎င်းတို့နှစ်ခုကို link လုပ်ပေးနိုင်ပါတယ်။

ကောင်းစွာရေးထားတဲ့ issue တစ်ခုက ခန့်မှန်းနိုင်တဲ့ ပုံစံတစ်ခုကို လိုက်နာပြီး ၎င်းကို လိုက်နာခြင်းက လူတိုင်းအတွက် အချိန်ကြာစေပါတယ်။

GitHub က ဒါအပေါ်မှာ organization layer တစ်ခုကို ထပ်ဖြည့်ပေးပါတယ်။

• Labels — issue ကို တစ်ချက်ကြည့်ရုံနှင့် ခွဲခြားပြီး busy repository ကို လက်ရှိအရေးကြီးအရာအထိ filter လုပ်ခွင့်ပြုသည်
• Assignees — ဘယ်သူတာဝန်ရှိလဲ မှတ်ပေးပြီး ထပ်ခါထပ်ခါ အလုပ်လုပ်မိခြင်းကို ရှောင်ရှားစေသည်
• Milestones — ဆက်စပ် issue နှင့် pull request များကို deadline သို့မဟုတ် release တစ်ခုတည်းအတွက် စုစည်းပေးသည်

ဒါတွေထဲမှာ မည်သည့်တစ်ခုမျှ မဖြစ်မနေမလိုအပ်ပါဘူး၊ ဒါပေမယ့် contributor နှစ်ဦးထက်ပိုတဲ့ repository မှန်သမျှမှာ ဒါတွေက အလုပ်ကို track မလုပ်နိုင်တော့တာကို ကာကွယ်ပေးတဲ့ အရာတွေပါပဲ။

ISSUE LIFECYCLE
---------------
opened --> labeled/assigned --> in progress --> linked PR --> closed
  |              |                    |              |            |
title +      bug/enhancement     someone owns   "Closes #12"   merged PR
description   milestone set          it          in a commit   auto-closes

လက်တွေ့ scenario နဲ့ ချိတ်ကြည့်မယ်

Issue ကို ကြည့်ခြင်း သို့မဟုတ် တင်ခြင်းက terminal ထဲမှာ လုံးဝ မဖြစ်ပေါ်ပါဘူး၊ ဒါပေမယ့် local Git နှင့် သိသာတဲ့ ချိတ်ဆက်မှုတစ်ခု သိထားထိုက်ပါတယ် — commit message များနှင့် pull request description များက issue ကို နံပါတ်ဖြင့် ရည်ညွှန်းနိုင်ပြီး Closes, Fixes, Resolves လို keyword တွေက ဆက်ဆံမှု ထူးခြားပါတယ်။

ဒီ link က အမြဲတမ်း ရှိနေပြီး နောင်တွင် ရှာဖွေနိုင်ပါတယ်၊ ဒါကြောင့် issue number ကို commit history ထဲမှာ ရှာခြင်းက GitHub website အပြင်မှာတောင် တကယ်အသုံးဝင်တဲ့ အလေ့အထတစ်ခုပါ။

Issue ကိုယ်တိုင်ပေါ်မှာတော့ အပေါ်ဆုံးမှာ description ကို တွေ့ရမယ်၊ ဆက်ပြီး comment thread၊ sidebar မှာ label နှင့် assignee ကို ပြသထားပြီး၊ အလုပ်စတင်တာနှင့် linked pull request တစ်ခု အလိုအလျောက် ပေါ်လာမှာပါ။

• Issue သည် code မဟုတ်သေးသော attention လိုအပ်သောအရာများအတွက် GitHub ၏ tracking unit ဖြစ်သည်
• ကောင်းသော issue တစ်ခုတွင် Problem, Expected, Actual, Steps to reproduce, Environment ပါဝင်သည်
• Labels, Assignees, Milestones သည် busy repository ကို organize လုပ်ရန် အသုံးဝင်သော lightweight tool များဖြစ်သည်

အတူတူ စမ်းရေးကြည့်မယ်

git init -q -b main
git config user.name "Thuta Learner"
git config user.email "learner@example.com"

cat > logger.js <<'EOF'
function log(value) {
  console.log(value.toUpperCase());
}
EOF
git add logger.js
GIT_AUTHOR_DATE="2026-01-01T09:00:00" GIT_COMMITTER_DATE="2026-01-01T09:00:00" \
  git commit -m "Add logger"

cat > logger.js <<'EOF'
function log(value) {
  if (value === undefined || value === null) return;
  console.log(value.toUpperCase());
}
EOF
git add logger.js
GIT_AUTHOR_DATE="2026-01-01T10:00:00" GIT_COMMITTER_DATE="2026-01-01T10:00:00" \
  git commit -m "Fixes #12: guard against undefined input in logger"

git log --oneline --grep="#12"

git log --oneline --grep="#12" ->
790939a Fixes #12: guard against undefined input in logger

GitHub ပေါ်မှာဆိုရင် commit ဒါမှမဟုတ် description ထဲမှာ 'Fixes #12' လို phrase ပါတဲ့ pull request တစ်ခု merge ဖြစ်သွားရင် issue #12 ကို အလိုအလျောက် ပိတ်ပေးပြီး ဘယ် commit နှင့် pull request က ဒါကို ဖြေရှင်းခဲ့လဲဆိုတာ note တစ်ခု issue ပေါ်မှာ ပေါ်လာပါလိမ့်မယ် — ဒါက GitHub web platform သီးသန့်ရဲ့ behavior ဖြစ်ပြီး git ကိုယ်တိုင် လုပ်ဆောင်တာ မဟုတ်ပါဘူး။

GitHub Docs: Creating an issue — Git & GitHub