Pull Request: GitHub ၏ အဓိက Workflow

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

Pull request ကို PR ဟု အတိုကောက်များသောအားဖြင့် ခေါ်ကြပြီး branch တစ်ခု၏ ပြောင်းလဲမှုများကို review လုပ်ပြီး merge ရန် တောင်းဆိုချက်တစ်ခုဖြစ်ပါတယ် — ပုံမှန်အားဖြင့် သင့် feature branch ကို main ထဲကို ပါပဲ။ ၎င်းသည် GitHub ၏ အဓိက workflow ဖြစ်ပါတယ်။

အဆင့်များက သင်သိပြီးသား local Git ပေါ်တည်ဆောက်ထားပါတယ် — branch တစ်ခု create လုပ်ပါ၊ code ပြောင်းလဲပါ၊ ပုံမှန်အတိုင်း commit လုပ်ပါ။

Pull request ကောင်းတစ်ခု၏ title က ပြောင်းလဲသွားတာကို ဝါကျတစ်ခုနှင့် တိကျစွာ ဖော်ပြရပါမယ် — 'fix stuff' မဟုတ်ဘဲ 'Add input validation to login form' လိုမျိုးပါ။ Description က ဘာကြောင့် ပြောင်းလဲရလဲ၊ ဘာမပါဝင်လဲ၊ ဆက်စပ် issue ကို link လုပ်ရမည်ကို ရှင်းပြပါတယ်။

THE PULL REQUEST FLOW
---------------------
branch --> commit --> push --> open PR --> review --> merge
  |          |          |         |           |          |
 git        git        git      GitHub     comments/   git merge
checkout    commit    push -u   (web UI)    approve     (server)
  -b

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

Pull request တစ်ခု ဖွင့်ခြင်း၏ local ပိုင်းက အောက်ပါ code ထဲမှာ တကယ်ဖြစ်ပျက်တာအတိုင်းပါပဲ — main ကနေ branch တစ်ခု create လုပ်ပါ၊ ဖိုင်တစ်ခု edit လုပ်ပါ၊ ပုံမှန် message ဖြင့် commit လုပ်ပါ၊ -u ဖြင့် push လုပ်ပါ။

Push output က remote ပေါ်မှာ branch အသစ် ရှိပြီဖြစ်ကြောင်း အတည်ပြုပေးပါတယ် — ဒါတစ်ခုတည်းနှင့် pull request မဖြစ်ပါဘူး။

၎င်းကို click နှိပ်လိုက်ရင် title နှင့် description field တွေပါဝင်တဲ့ form တစ်ခု ပွင့်လာပါတယ်။ reviewer တွေ notify ရရှိပြီး comment နှင့် တောင်းဆိုထားတဲ့ change တွေ diff ပေါ်မှာ inline ပေါ်လာပြီး approve ဖြစ်သွားရင် merge button တစ်ခု ရနိုင်လာပါတယ်။

Web-side interaction ဒါတွေ ဘယ်ဟာမှ terminal command မရှိပါဘူး — local ပိုင်းကို ခိုင်မာတယ်လို့ ခံစားရအောင် push ကို ကိုယ်တိုင် run ကြည့်ပါ။

• Pull request သည် branch တစ်ခု၏ ပြောင်းလဲမှုများကို review လုပ်ပြီး merge ရန် တောင်းဆိုချက်တစ်ခုဖြစ်သည်
• Push -u ပြီးမှသာ GitHub ဘက်မှ PR ဖွင့်ခြင်းစတင်နိုင်သည် — push တစ်ခုတည်းက PR ကို auto-create မလုပ်ပါ
• Title က တိကျပြီး description က why ကို ရှင်းပြရမည် — ချုံ့ငယ်၊ focused ဖြစ်သော PR များက ပိုမြန်စွာ review ခံရသည်

Pull Request မဖွင့်ခင် စစ်ဆေးရန်

• Title က ပြောင်းလဲသွားတာကို ဝါကျတစ်ခုနှင့် တိကျစွာ ဖော်ပြထားသည်
• Description က ဘာပြောင်းလဲသလဲ၊ ဘာကြောင့်ပြောင်းလဲရသလဲကို ရှင်းရှင်းလင်းလင်း ဖော်ပြထားသည်
• သက်ဆိုင်ရာ issue ရှိလျှင် link ထားသည် (ဥပမာ "Closes #12")
• local မှာ test များ အောင်မြင်ကြောင်း စစ်ဆေးပြီးပြီ
• မသက်ဆိုင်သော ပြောင်းလဲမှုများ ရောနှောမပါ
• အခြားသူကို မတောင်းဆိုခင် ကိုယ်တိုင် diff ကို တစ်ခေါက် ပြန်ကြည့်ပြီးပြီ

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

# A local bare repo stands in for the GitHub-hosted remote, so branching,
# committing, and pushing below are all genuinely real -- only opening the
# actual Pull Request afterward happens on GitHub's website.
git init -q --bare ../remote-demo.git
git init -q -b main
git config user.name "Thuta Learner"
git config user.email "learner@example.com"
git remote add origin ../remote-demo.git

echo "// app entry point" > app.js
git add app.js
GIT_AUTHOR_DATE="2026-01-01T09:00:00" GIT_COMMITTER_DATE="2026-01-01T09:00:00" \
  git commit -m "Initial commit"
git push -u origin main

git checkout -b feature/add-login
echo "function login() { return true; }" > login.js
git add login.js
GIT_AUTHOR_DATE="2026-01-01T10:00:00" GIT_COMMITTER_DATE="2026-01-01T10:00:00" \
  git commit -m "Add basic login function"
git push -u origin feature/add-login

git push -u origin main ->
To <remote-url>
 * [new branch]      main -> main
branch 'main' set up to track 'origin/main'.

git checkout -b feature/add-login လုပ်ပြီး commit လုပ်ပြီးနောက်:

git push -u origin feature/add-login ->
To <remote-url>
 * [new branch]      feature/add-login -> feature/add-login
branch 'feature/add-login' set up to track 'origin/feature/add-login'.

GitHub-hosted remote အစစ်တစ်ခုပေါ်မှာဆိုရင် branch အသစ်တစ်ခု push လုပ်တာနှင့် GitHub က 'Compare & pull request' banner ကို repository page ပေါ်မှာပါ ပြပါလိမ့်မယ် — အဲဒီအပိုင်းက GitHub website ပေါ်မှာသာ ပေါ်လာပြီး ဒီ terminal output ထဲမှာ မပါဝင်ပါဘူး။

GitHub Docs: About pull requests — Git & GitHub