Working in GitHub Codespaces (GitHub Codespaces မှာ အလုပ်လုပ်ပုံ)

Programming သင်ခန်းစာတွေမှာ ပါတဲ့ GitHub Classroom (ဆရာက assignment တွေ ပေးပြီး စစ်ဆေးနိုင်တဲ့ GitHub ရဲ့ ဝန်ဆောင်မှု) assignment (ဆရာ ပေးတဲ့ လုပ်ရမယ့် အလုပ်) တွေကို Codespace တစ်ခုထဲမှာ ဖွင့်ပါတယ်။ Codespace ဆိုတာ လိုအပ်တာ အားလုံး ကြိုတင် ပြင်ဆင်ထားပြီးသား browser ထဲက code editor (code ရေးတဲ့ software) တစ်ခုပါ။ ဒီလမ်းညွှန်က assignment ကို လက်ခံတာကနေ ဆရာ့ရဲ့ feedback (ပြန်လည် အကြံပြုချက်) ကို ဖတ်တဲ့အထိ ပြပေးပါတယ်။ Assignment တိုင်းအတွက် အဆင့်တွေ အတူတူပါပဲ။ File နာမည်ပဲ ပြောင်းပါတယ်။

  1. 1. Assignment ကို လက်ခံပြီး Codespace ကို ဖွင့်ပါ
    1. Java မှာ Standard mode ကို ရွေးပါ
  2. 2. Code ရေးပြီး စစ်ဆေးပါ
  3. 3. အလုပ်ကို တင်ပြီး feedback ကို ဖတ်ပါ
    1. ဆရာ့ရဲ့ feedback ကို ဖတ်ခြင်း

1. Assignment ကို လက်ခံပြီး Codespace ကို ဖွင့်ပါ

  1. သင်ခန်းစာ စာမျက်နှာမှာ Accept the assignment on GitHub (GitHub မှာ assignment ကို လက်ခံပါ) ကို ရွေးပါ၊ ပြီးရင် အစိမ်းရောင် Accept this assignment (ဒီ assignment ကို လက်ခံပါ) ခလုတ်ကို နှိပ်ပါ။
  2. ကိုယ့် GitHub account မှာ ပေးထားတဲ့ email လိပ်စာကို GitHub က email တစ်စောင် ပို့ပါတယ်။ အဲဒီ email ထဲက link ကို ဖွင့်ပါ။ အဲဒီ link က ကိုယ်ပိုင် assignment copy ဆီ တိုက်ရိုက် ရောက်စေတာမို့ ဘယ်သူမှ link ကို မျှပေးဖို့ မလိုပါဘူး။
  3. ကိုယ့် repository (project ရဲ့ file တွေကို သိမ်းထားတဲ့ GitHub ပေါ်က နေရာ) အဆင်သင့် ဖြစ်တဲ့အခါ Open in Codespace (Codespace ထဲမှာ ဖွင့်ပါ) ကို နှိပ်ပြီး browser ထဲမှာ editor ပေါ်လာတဲ့အထိ စောင့်ပါ။

ပထမဆုံး အကြိမ်မှာ အသိပေးချက် နှစ်ခု ပေါ်လာပါတယ်။ နှစ်ခုလုံး assignment ရဲ့ အစိတ်အပိုင်း မဟုတ်ပါဘူး:

  • “Would you like VS Code to periodically run git fetch?” (GitHub ပေါ်က ပြောင်းလဲမှုတွေကို VS Code က အချိန်မှန်မှန် အလိုအလျောက် စစ်ယူစေချင်လား လို့ မေးတာပါ)။ No (မလုပ်ပါ) ကို နှိပ်ပါ။
  • “There’s a pull request associated with main.” (main branch နဲ့ ဆက်စပ်တဲ့ pull request (ပြင်ဆင်ချက်တွေကို စစ်ဆေး ဆွေးနွေးဖို့ GitHub မှာ ဖွင့်ထားတဲ့ တောင်းဆိုချက်) တစ်ခု ရှိတယ် လို့ ပြောတာပါ)။ Don’t Show Again (နောက်ထပ် မပြပါနဲ့) ကို နှိပ်ပါ။

Java မှာ Standard mode ကို ရွေးပါ

Editor ရဲ့ အောက်ခြေ တစ်လျှောက်က status bar (editor ရဲ့ အခြေအနေကို ပြတဲ့ အောက်ခြေ bar) ကို ကြည့်ပါ။ အဲဒီမှာ Java: Lightweight Mode (Java ပေါ့ပေါ့ပါးပါး mode) လို့ ပြနေရင် အဲဒါကို ရွေးပြီး Standard (ပုံမှန် mode) ကို ရွေးပါ၊ ပြီးရင် Java: Ready (Java အသင့်ဖြစ်ပြီ) လို့ ပြတဲ့အထိ စောင့်ပါ။ Lightweight mode မှာ Run (code ကို run ပေးတဲ့) ခလုတ် မပေါ်ဘဲ Java က “Main method not found” (main method ကို ရှာမတွေ့ဘူး) လို့ ပြပါတယ်။

Java Lightweight mode မှာ ရှိနေတဲ့ status bar Editor ရဲ့ အောက်ခြေ bar မှာ branch နာမည် main နဲ့ Java: Lightweight Mode ဆိုတဲ့ စာ ပါပါတယ်။ အဲဒီ စာကို ရွေးလိုက်ရင် Lightweight နဲ့ Standard ထဲက တစ်ခုကို ရွေးလို့ရတဲ့ စာရင်း ပေါ်လာပါတယ်။ main Java: Lightweight Mode Lightweight Standard
Status bar မှာ Java: Lightweight Mode ကို ရွေးပြီး Standard ကို ရွေးပါ။

Python မှာတော့ ပြောင်းစရာ mode မရှိပါဘူး: Run ခလုတ်က editor ရဲ့ ညာဘက် အပေါ်ထောင့်မှာ ရှိပါတယ်။

2. Code ရေးပြီး စစ်ဆေးပါ

  1. သင်ခန်းစာမှာ ဖော်ပြထားတဲ့ file ကို src folder ထဲမှာ ဖွင့်ပါ။ ပြင်ရမယ့် file က အဲဒီ file တစ်ခုတည်းပါ။
  2. TODO (လုပ်ရန် ကျန်တဲ့ အလုပ်ကို ပြတဲ့ မှတ်ချက်) တစ်ခုစီကို အစဉ်လိုက် ပြီးအောင် လုပ်ပါ။ အလုပ် တစ်ခုစီရဲ့ အပေါ်က comment (code ထဲမှာ ရှင်းပြချက်အဖြစ် ရေးထားတဲ့ စာ) က အဲဒီ အလုပ်က print ထုတ်ရမယ့် output ကို ပြပါတယ်။
  3. ကိုယ့်အလုပ်ကို နည်းလမ်း နှစ်မျိုးထဲက တစ်မျိုးနဲ့ စစ်ပါ:
    • Run လုပ်ကြည့်ခြင်း: Run ကို နှိပ်ပါ (Java မှာ main ရဲ့ အပေါ်မှာ၊ Python မှာ ညာဘက် အပေါ်ထောင့်မှာ ရှိပါတယ်)၊ ပြီးရင် print ထုတ်လာတာကို မျှော်လင့်ထားတဲ့ output နဲ့ နှိုင်းယှဉ်ပါ။
    • Test တွေ run ခြင်း: Terminal > New Terminal (Terminal menu ထဲက terminal အသစ်) ကို ဖွင့်ပါ။ Terminal ဆိုတာ command တွေ ရိုက်ထည့်ပြီး run တဲ့ window ပါ။ bash run-tests.sh လို့ ရိုက်ပြီး Enter ကို နှိပ်ပါ။ အစိမ်းရောင် အမှန်ခြစ်က test (code မှန်မမှန် အလိုအလျောက် စစ်တဲ့ အစီအစဉ်) တစ်ခု အောင်တယ်လို့ ဆိုလိုပါတယ်။ အနီရောင် ကြက်ခြေခတ်က test က ဘာကို မျှော်လင့်ထားလဲ ပြတာကြောင့် ဘာကို ပြင်ရမလဲ သိနိုင်ပါတယ်။

3. အလုပ်ကို တင်ပြီး feedback ကို ဖတ်ပါ

  1. ဘယ်ဘက် bar ထဲက Source Control (code ပြောင်းလဲမှုတွေကို စီမံတဲ့ panel) icon (branch ပုံစံ icon) ကို ရွေးပါ။
  2. completed tasks လို message တိုတိုလေး ရိုက်ပြီး Commit (ပြောင်းလဲမှုတွေကို version တစ်ခုအဖြစ် မှတ်တမ်းတင်ပါ) ကို နှိပ်ပါ။ ပြောင်းလဲမှု အားလုံးကို stage (commit ထဲ ထည့်ဖို့ ရွေးထား) လုပ်မလား မေးရင် Always (အမြဲတမ်း) ကို ရွေးပါ။
  3. Sync Changes (ပြောင်းလဲမှုတွေကို GitHub နဲ့ ချိန်ညှိပါ) ကို နှိပ်ပါ။ Push (ကိုယ့် commit တွေကို GitHub ဆီ ပို့ခြင်း) နဲ့ pull (GitHub ပေါ်က ပြောင်းလဲမှုတွေကို ဆွဲယူခြင်း) အကြောင်း မေးရင် OK, Don’t Show Again (ရပါပြီ၊ နောက်ထပ် မပြပါနဲ့) ကို ရွေးပါ။
Source Control မှာ commit လုပ်ပြီး sync လုပ်ခြင်း Source Control panel မှာ completed tasks လို့ ရေးထားတဲ့ message box တစ်ခု၊ အဲဒီ အောက်မှာ Commit ခလုတ်နဲ့ commit လုပ်ပြီးနောက် နှိပ်ရမယ့် Sync Changes ခလုတ် ပါပါတယ်။ SOURCE CONTROL completed tasks Commit then Sync Changes The autograder runs, and your teacher sees the result.
Message တစ်ခု ရေးပြီး Commit ကို နှိပ်ပါ၊ ပြီးရင် Sync Changes ကို နှိပ်ပါ။

Autograder (GitHub ရဲ့ အလိုအလျောက် test တွေ) က သူ့အလိုလို run ပြီး ဆရာက GitHub Classroom dashboard (အချက်အလက်တွေကို စုပြတဲ့ စာမျက်နှာ) မှာ ရလဒ်ကို မြင်ရပါတယ်။

ဆရာ့ရဲ့ feedback ကို ဖတ်ခြင်း

  1. GitHub ပေါ်မှာ ကိုယ့် repository ကို ဖွင့်ပြီး Pull requests (pull request များ) tab ကို ရွေးပါ။
  2. Feedback လို့ နာမည်ပေးထားတဲ့ pull request ကို ဖွင့်ပါ၊ ပြီးရင် Files changed (ပြောင်းထားတဲ့ file များ) tab ကို ဖွင့်ပါ။ ဆရာ့ရဲ့ မှတ်ချက်တွေက သူတို့ ပြောချင်တဲ့ line တွေရဲ့ ဘေးမှာ ရှိပါတယ်။
  3. Codespace ထဲမှာ code ကို ပြင်ပါ၊ စစ်ဖို့ bash run-tests.sh ကို run ပါ၊ ပြီးရင် commit နဲ့ sync ကို ထပ်လုပ်ပါ (အပိုင်း 3)။ Autograder က ထပ် run ပါတယ်။