AGENTS.md

translations/my/AGENTS.md

AGENTS.md

Quality

81/100

Scores the file, not the repository.

Length

1,547 words

59 headings · 12 code blocks

Repository

96k

— · pushed 3 days ago

Last changed

3 days ago

First indexed 3 days ago.

microsoft/Web-Dev-For-Beginners/translations/my/AGENTS.mdRaw GitHub

1# AGENTS.md
2 
3## Project Overview
4 
5ဒါဟာ ဝဘ်ဒီဗလပ်မှန်အခြေခံမှုများကို စတင်လေ့လာသူများအတွက် သင်ကြားပေးရန် အရည်အချင်းမြှင့်ပညာရေး သင်ရိုးညွှန်းလမ်းကြောင်း ရှည်လျားသော ထောက်ပံ့မှုပလက်ဖောင်းတစ်ခု ဖြစ်သည်။ သင်ရိုးညွှန်းလမ်းကြောင်းမှာ Microsoft Cloud Advocates မှ ဖန်တီးထားသော 12 နာရီကြာ သင်တန်း ၁၂ ပတ် တစ်ခု ဖြစ်ပြီး JavaScript, CSS, နှင့် HTML ကို မျက်နှာသာသော သင်ခန်းစာ ၂၄ ခု ပါဝင်သည်။
6 
7### Key Components
8 
9- **ပညာရေး အကြောင်းအရာများ**: စီစဉ်ထားသော သင်ခန်းစာ ၂၄ ခန်းများ၊ စီမံကိန်းလိုက် မော်ဂျူလ်များအဖြစ်
10- **လက်တွေ့ ပရောဂျက်များ**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, နှင့် AI Chat Assistant
11- **အပြန်အလှန် စာမေးပွဲများ**: တစ်ခုခြင်း သင်ခန်းစာ မတိုင်မီ နှင့် သင်ခန်းစာပြီးနောက် အကဲဖြတ်ရန် မေးခွန်း ၃ မျိုး ပါဝင်သည့် စာမေးပွဲ ၄၈ ခု
12- **ဘာသာစကားပေါင်းများစွာ အထောက်အပံ့**: GitHub Actions မှ တစ်ဆင့် ဘာသာစကား ၅၀ ကျော် အလိုအလျောက် ဘာသာပြန်ခြင်း
13- **နည်းပညာများ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ပရောဂျက်များအတွက်)
14 
15### Architecture
16 
17- သင်ခန်းစာအခြေခံ ပညာရေး ဒေတာဗေ့စ်
18- သင်ခန်းစာ တစ်ခုချင်း အတွင်း README, ကုဒ်နမူနာများ နှင့် နည်းလမ်း ဖြေရှင်းချက်များ ပါဝင်သည်
19- စကြာ ဝင်ပေါက်ရှိသော ပရောဂျက်များ ကို ထူးခြားသော ဖိုလ်ဒါများတွင် ထားရှိသည် (quiz-app, စသည်)
20- GitHub Actions (co-op-translator) ကို အသုံးပြု၍ ဘာသာပြန်စနစ်
21- Docsify ဖြင့် စာရွက်စာတမ်းများကို ဝန်ဆောင်မှုပေးပြီး PDF အဖြစ်လည်းရနိုင်သည်
22 
23## Setup Commands
24 
25ဒီ ဒေတာဗေ့စ်ကို စင်စစ်ပညာရေး အကြောင်းအရာ အသုံးပြုရုံအတွက် အဓိက ရည်ရွယ်သည်။ အထူးပရောဂျက်များနှင့် လုပ်ကိုင်ရန်အတွက်:
26 
27### Main Repository Setup
28 
29```bash
30git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
31cd Web-Dev-For-Beginners
32```
33 
34### Quiz App Setup (Vue 3 + Vite)
35 
36```bash
37cd quiz-app
38npm install
39npm run dev        # ဖွံ့ဖြိုးမှုဆာဗာကို စတင်ပါ
40npm run build      # ထုတ်လုပ်မှုအတွက် တည်ဆောက်ပါ
41npm run lint       # ESLint ကို chạyပါ
42```
43 
44### Bank Project API (Node.js + Express)
45 
46```bash
47cd 7-bank-project/api
48npm install
49npm start          # API ဆာဗာ စတင်ပါ
50npm run lint       # ESLint ကို ပြေးပါ
51npm run format     # Prettier ဖြင့် ပုံစံစစ်ဆေးပါ
52```
53 
54### Browser Extension Projects
55 
56```bash
57cd 5-browser-extension/solution
58npm install
59# ဘရောက်ဇာအသီးသီးထည့်သွင်းနည်းလမ်းညွှန်များကိုလိုက်နာပါ
60```
61 
62### Space Game Projects
63 
64```bash
65cd 6-space-game/solution
66npm install
67# index.html ကို browser မှာဖွင့်ပါ သို့မဟုတ် Live Server ကိုအသုံးပြုပါ
68```
69 
70### Chat Project (Python Backend)
71 
72```bash
73cd 9-chat-project/solution/backend/python
74pip install openai
75# GITHUB_TOKEN ပတ်ဝန်းကျင်အပြောင်းအလဲ ကို သတ်မှတ်ပါ
76python api.py
77```
78 
79## Development Workflow
80 
81### For Content Contributors
82 
831. **ရိုက်နှိပ်ပြီး fork လုပ်ရန်** မိမိ၏ GitHub အကောင့်သို့
842. **fork ကို clone လုပ်ပါ** ဒေသခံစနစ်သို့
853. **သင်ပြင်ဆင်လိုသော ဗားရှင်း အသစ် ဖန်တီးပါ**
864. သင်ခန်းစာ အကြောင်းအရာ သို့မဟုတ် ကုဒ်နမူနာများ ပြင်ဆင်ပါ
875. ပရောဂျက်တွင် ကုဒ်ပြင်ဆင်မှုများ ရရှိပါက စမ်းသပ်ပါ
886. အကူအညီအဖွဲ့ ဆောင်ရွက်နေသော လမ်းညွှန်ချက်များအတိုင်း pull request တင်သွင်းပါ
89 
90### For Learners
91 
921. Fork လုပ် သို့မဟုတ် clone လုပ်ပါ
932. သင်ခန်းစာ ဖိုလ်ဒါများကို နောက်တတ်တိုက် တိုင်ရွက်ပါ
943. သင်ခန်းစာမျက်နှာများကို ဖတ်ရှုပါ
954. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မီ စာမေးပွဲ ဖြေဆိုပါ
965. သင်ခန်းစာဖိုလ်ဒါများတွင် ကုဒ်နမူနာများကို လေ့လာပါ
976. အလုပ်အပ်နှင့် စိန်ခေါ်မှုများ ပြီးမြောက်အောင် ဆောင်ရွက်ပါ
987. သင်ခန်းစာပြီးနောက် စာမေးပွဲများ ဖြေဆိုပါ
99 
100### Live Development
101 
102- **စာရွက်စာတမ်းများ**: ကိုယ်ပိုင် `docsify serve` ကို root တွင်ချပြရန် (port 3000)
103- **Quiz App**: quiz-app ဖိုလ်ဒါတွင် `npm run dev` ဖြစ်စေပါ
104- **ပရောဂျက်များ**: VS Code ရဲ့ Live Server extension ကို HTML ပရောဂျက်များအတွက် အသုံးပြုပါ
105- **API ပရောဂျက်များ**: အဆိုပါ API ဖိုလ်ဒါများတွင် `npm start` ချပြပါ
106 
107## Testing Instructions
108 
109### Quiz App Testing
110 
111```bash
112cd quiz-app
113npm run lint       # ကုဒ်ပုံစံ ပြဿနာများကို စစ်ဆေးပါ
114npm run build      # ဖွဲ့စည်းမှု အောင်မြင်မှုကို အတည်ပြုပါ
115```
116 
117### Bank API Testing
118 
119```bash
120cd 7-bank-project/api
121npm run lint       # ကုဒ်စတိုင်ပြဿနာများကို စစ်ဆေးပါ
122node server.js     # အမှားများမရှိဘဲ ဆာဗာစတင်သည်ကို သေချာစစ်ဆေးပါ
123```
124 
125### General Testing Approach
126 
127- ဒေတာဗေ့စ်သည် အလိုအလျောက် စမ်းသပ်မှု ပုံမှန် မပါဝင်သော ပညာရေးစနစ်ဖြစ်သည်
128- စမ်းသပ်မှုများကို လက်မှုပုံစံဖြင့် အောက်ပါအတိုင်း အာရုံစိုက်ပါသည် -
129  - ကုဒ်နမူနာများ အမှားမဖြစ်စေဘဲ ပြေးပါခြင်း
130  - စာရွက်စာတမ်းတွင် မျှဝေထားသော လင့်ခ်များ အလုပ်လုပ်ရခြင်း
131  - ပရောဂျက်တည်ဆောက်မှု ပြီးမြောက်ခြင်း
132  - နမူနာများသည် ကောင်းမွန်သော လေ့လာမှုနည်းလမ်းများကို လိုက်နာခြင်း
133 
134### Pre-submission Checks
135 
136- package.json ပါဝင်သော ဖိုလ်ဒါများတွင် `npm run lint` ကို တင်သတ်ပါ
137- markdown လင့်ခ်များကို မှန်ကန်ပြည့်စုံကြောင်း အတည်ပြုပါ
138- ဘရောက်ဇာ နှင့် Node.js တို့တွင် ကုဒ်နမူနာများကို စမ်းသပ်ပါ
139- ဘာသာပြန်မှုများ၏ ဖွဲ့စည်းမှု မြောက်မြားမှု ထိန်းသိမ်းထားမှု စိစစ်ပါ
140 
141## Code Style Guidelines
142 
143### JavaScript
144 
145- ခေတ်မီ ES6+ စာရေးနည်းကို အသုံးပြုပါ
146- ပရောဂျက်အတွင်း ပါရှိသည့် standard ESLint ပြဿနာစနစ်ကို လိုက်နာပါ
147- ပညာရေး ရည်ရွယ်ချက်အတွက် သီးခြား နာမည်များ အသုံးပြုပါ
148- လေ့လာသူများအတွက် အဓိပ္ပာယ်ဖွင့်ရှင်းချက်များ စာသားတွေ ထည့်ပါ
149- Prettier ဖြင့် ပုံစံ စနစ်တကျ ပြုပြင်ထားပါ (configured ရှိလျှင်သာ)
150 
151### HTML/CSS
152 
153- Semantic HTML5 element များအသုံးပြုခြင်း
154- တုန့်ပြန်မှု ဒီဇိုင်း များကို ဆောင်ရွက်ခြင်း
155- Class နာမည်များကို ရှင်းလင်းသတိပြုအသုံးပြုပါ
156- CSS နည်းကျများအတွက် သင်ယူသူများအတွက် ရှင်းလင်းရေးသားချက်များ ထည့်ပါ
157 
158### Python
159 
160- PEP 8 စံချိန်စံညွှန်းများ လိုက်နာပါ
161- တိကျမြောက်မရှိ ပညာရေးကုဒ်နမူနာများ
162- သင်ယူမှု အတွက် အကူအညီဖြစ်စေသည့် Type hints များထည့်ပါ
163 
164### Markdown Documentation
165 
166- ခေါင်းစဥ် အဆင့်လိုက် ရှင်းလင်းမှု
167- ဝါကျဘာသာပြန်ထားသော ကုဒ် ဘလော့တွေ
168- အသေးစိတ် ရင်းမြစ်များအတွက် လင့်ခ်များ
169- `images/` ဖိုလ်ဒါများတွင် ပုံရိပ်များနှင့် စာရင်းများ
170- ရှာဖွေသူများအတွက် ပုံများ၏ Alt စာသားများ
171 
172### File Organization
173 
174- သင်ခန်းစာများ ကို နံပါတ်လိုက် စီစဉ်ထား (1-getting-started-lessons, 2-js-basics, စသည်)
175- ပရောဂျက်တစ်ခုချင်းစီတွင် `solution/` နှင့် တခုခုသော `start/` သို့မဟုတ် `your-work/` ဖိုလ်ဒါများပါဝင်သည်
176- ပုံရိပ်များသည် သင်ခန်းစာအလိုက် `images/` ဖိုလ်ဒါများတွင် သိမ်းဆည်းထားသည်
177- ဘာသာပြန်ထားသော ဖိုင်များကို `translations/{language-code}/` ဖိုလ်ဒါတွင် သိမ်းဆည်းထားသည်
178 
179## Build and Deployment
180 
181### Quiz App Deployment (Azure Static Web Apps)
182 
183quiz-app သည် Azure Static Web Apps အဆောက်အအုံအတွက် ဆက်တင်ပြုလုပ်ထားသည် -
184 
185```bash
186cd quiz-app
187npm run build      # dist/ အဖိုင်ထည် ဆောက်သည်
188# main ထိ တင်သွင်းသောအခါ GitHub Actions workflow ဖြင့် တင်စစ်သည်။
189```
190 
191Azure Static Web Apps ဆက်တင်များ:
192- **App ရှေ့နေရာ**: `/quiz-app`
193- **အထွက် ရှေ့နေရာ**: `dist`
194- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
195 
196### Documentation PDF Generation
197 
198```bash
199npm install                    # docsify-to-pdf ကို ထည့်သွင်းပါ
200npm run convert               # docs မှ PDF ကို ထုတ်လုပ်ပါ
201```
202 
203### Docsify Documentation
204 
205```bash
206npm install -g docsify-cli    # Docsify ကို ကမ္ဘာလုံးဆိုင်ရာ ထည့်သွင်းပါ
207docsify serve                 # localhost:3000 တွင် ဝန်ဆောင်မှုပေးပါ
208```
209 
210### Project-specific Builds
211 
212ပရောဂျက် တစ်ခုချင်းစီ၏ build လုပ်ငန်းစဉ်သည် မတူကွဲပြားနိုင်ပါသည် -
213- Vue ပရောဂျက်များ: `npm run build` နှင့် production bundle များ ဖန်တီးသည်
214- Static ပရောဂျက်များ: build လုပ်ခြင်းမရှိဘဲ ဖိုင်များကို တိုက်ရိုက် ဝန်ဆောင်မှု ပြုလုပ်သည်
215 
216## Pull Request Guidelines
217 
218### Title Format
219 
220ပြင်ဆင်ချက် အကွာအဝေးပြသနိုင်စေရန် ခေါင်းစဉ်များကို ရှင်းလင်းဖော်ပြပါ:
221- `[Quiz-app] သင်ခန်းစာ X အတွက် စာမေးပွဲ အသစ် ထည့်သွင်းပါ`
222- `[Lesson-3] Terrarium ပရောဂျက်တွင် သိပ်ချောင်းမှုတစ်ခု ပြင်ဆင်သည်`
223- `[Translation] သင်ခန်းစာ 5 အတွက် စပိန်ဘာသာပြန် ထည့်သွင်းပါ`
224- `[Docs] အဆင်ပြေမှု နည်းလမ်းညွှန်ချက် များ ထပ်မံ ပြင်ဆင်ပါ`
225 
226### Required Checks
227 
228PR တင်မတိုင်မီ လူအတတ်ဆုံး စစ်ဆေးမှုများ -
229 
2301. **ကုဒ်အရည်အသွေး**:
231   - ဒဏ်ရာရှိသော ပရောဂျက် ဖိုလ်ဒါများတွင် `npm run lint` ထည့်ပြေးပါ
232   - lint အမှားများနှင့် သတိပေးချက်များအားလုံး ပြင်ဆင်သည်
233 
2342. **Build အတည်ပြုမှု**:
235   - မည်သည့် အခါတွင်မဆို `npm run build` ကို ပြေးပါ
236   - Build အမှား မရှိကြောင်း သေချာစေပါ
237 
2383. **လင့်ခ် စစ်ဆေးမှု**:
239   - Markdown လင့်ခ်များအားလုံးကို စမ်းသပ်ပါ
240   - ပုံရိပ်ကိုင်တွယ်မှုများ ကို စစ်ဆေးပါ
241 
2424. **အကြောင်းအရာ ပြန်လည်သုံးသပ်မှု**:
243   - စာလုံးပေါင်းနှင့် အသံဖွဲ့မှု စစ်ဆေးပါ
244   - ကုဒ် နမူနာများ မှန်ကန်ပြီး ပညာရေးအတွက်သင့်တော်သည်ကို သေချာစေပါ
245   - ဘာသာပြန်မှုများသည် မူရင်း အဓိပ္ပါယ်ကို ထိန်းသိမ်းထားသည်ကို အတည်ပြုပါ
246 
247### Contribution Requirements
248 
249- Microsoft CLA (အသစ် PR အတွက် အလိုအလျောက် စစ်ဆေးမှု) ပေးအပ်ရန် သဘောတူပါရန်
250- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ကို လိုက်နာပါ
251- အသေးစိတ် လမ်းညွှန်မှုအတွက် [CONTRIBUTING.md](./CONTRIBUTING.md) ဖတ်ရှုပါ
252- PR ဖေါ်ပြချက်တွင် ဆိုင်သော ပြဿနာအမှတ်များ ကို ပြုလုပ်ပါ
253 
254### Review Process
255 
256- PR များကို မိမိ ဦးဆောင်သူများ နှင့် အသိုင်းအဝိုင်းက ရှင်းလင်း ပြန်လည်သုံးသပ်သည်
257- ပညာရေး အပြည့်အဝ ရနိုင်ရေးကို ဦးစားပေးသည်
258- ကုဒ် နမူနာများသည် လက်ရှိ အကောင်းဆုံးနည်းလမ်းများနှင့် ကိုက်ညီရမည်
259- ဘာသာပြန်မှုများကို တိကျမှုနဲ့ ယဉ်ကျေးမှုသဘောထား အရ အကဲဖြတ်သည်
260 
261## Translation System
262 
263### Automated Translation
264 
265- GitHub Actions နှင့် co-op-translator workflow ကို အသုံးပြုသည်
266- ဘာသာစကား ၅၀ ကျော်သို့ အလိုအလျောက် ဘာသာပြန်ပေးသည်
267- မူရင်းဖိုင်များကို မူရင်း ဖိုလ်ဒါများတွင် တင်ရှိသည်
268- ဘာသာပြန်သော ဖိုင်များကို `translations/{language-code}/` ကုဒ်လမ်းကြောင်းတွင်ထားသည်
269 
270### Adding Manual Translation Improvements
271 
2721. `translations/{language-code}/` ဖိုလ်ဒါအတွင်း ဖိုင်ရှာဖွေပါ
2732. ဖွဲ့စည်းမှု မဖျက်ဆီးဘဲ တိုးတက်အောင် ပြင်ဆင်ပါ
2743. ကုဒ်နမူနာများ အလုပ်လုပ်နိုင်မှု ထိန်းသိမ်းပါ
2754. ဒေသဆိုင်ရာ စာမေးပွဲအကြောင်းအရာများ တင်ပြပါ
276 
277### Translation Metadata
278 
279ဘာသာပြန်ထားသော ဖိုင်များတွင် metadata ခေါင်းစီးပါရှိသည် -
280```markdown
281<!--
282CO_OP_TRANSLATOR_METADATA:
283{
284  "original_hash": "...",
285  "translation_date": "...",
286  "source_file": "...",
287  "language_code": "..."
288}
289-->
290```
291 
292## Debugging and Troubleshooting
293 
294### Common Issues
295 
296**Quiz app မသွင်းနိုင်သော ပြဿနာ**:
297- Node.js ဗားရှင်း (v14+ ဟု အကြံပြု)
298- `node_modules` နှင့် `package-lock.json` ဖိုင်များ ဖျက်ပြီး `npm install` ပြန်ပြုလုပ်ပါ
299- Port မတူညီမှု (Vite ၏ ပုံမှန် port သည် 5173)
300 
301**API server မတက်နိုင်ခြင်း**:
302- Node.js ဗားရှင်း (node >=10) ကို အတည်ပြုပါ
303- Port သုံးပြီးသားရှိမရှိ စစ်ဆေးပါ
304- မလိုအပ်သည့် package များ install လုပ်ထားမရှိကြောင်း စစ်ဆေးပါ
305 
306**Browser extension မရောက်ရှိခြင်း**:
307- manifest.json ကို မှန်ကန်စွာ စနစ်တကျ ဖန်တီးထားမှု စစ်ဆေးပါ
308- Browser console အမှားများ စစ်ဆေးပါ
309- Browser-specific extension တပ်ဆင်ခြင်း လမ်းညွှန်ချက်များလိုက်နာပါ
310 
311**Python chat project ပြဿနာများ**:
312- OpenAI package ကို တပ်ဆင်ထားမှုရှိ/မရှိ စစ်ဆေးပါ `pip install openai`
313- GITHUB_TOKEN environment variable ကို သတ်မှတ်ထားမှု ချက်ချင်းစစ်ဆေးပါ
314- GitHub Models သုံးခွင့်ရှိမှုကို အတည်ပြုပါ
315 
316**Docsify စာရွက်စာတမ်း မပေးနိုင်မှု**:
317- docsify-cli ကို ဘောလုံးအဆင့် တပ်ဆင်ပါ `npm install -g docsify-cli`
318- ဒေတာဗေ့စ် root ဖိုလ်ဒါမှ ကြိုးစားပြေးပါ
319- `docs/_sidebar.md` ဖိုင် ရှိမှုကို စစ်ဆေးပါ
320 
321### Development Environment Tips
322 
323- HTML ပရောဂျက်များအတွက် VS Code Live Server အက်စတင်းရှင်းအသုံးပြုပါ
324- မျှတသော format ဖြင့်ရေးသားရန် ESLint နှင့် Prettier extension များ ထည့်သွင်းပါ
325- JavaScript debugging အတွက် browser DevTools သုံးပါ
326- Vue ပရောဂျက်များအတွက် Vue DevTools browser extension ထည့်သွင်းပါ
327 
328### Performance Considerations
329 
330- ဘာသာပြန်ဖိုင် နေရာအများစုသောကြောင့် (ဘာသာစကား ၅၀+) လုံးဝ clone လုပ်ရာတွင် များစွာဖိုင်များ ဖြစ်ပေါ်နိုင်သည်
331- အကြောင်းအရာ အလျင်အမြန် ရယူရန် `git clone --depth 1` ကို အသုံးပြုပါ
332- ဗမာဘာသာ အကြောင်းအရာများတွင် သင်တန်းသား content တွင် ဘာသာပြန်ဖိုင်များကို ရှာဖွေရန် မထည့်ပါနှင့်
333- npm install နှင့် Vite build တို့ကဲ့သို့ build လုပ်ဆောင်မှုများ ပထမအကြိမ် run မှာ နှေးကွေးဖြစ်တတ်ပါသည်
334 
335## Security Considerations
336 
337### Environment Variables
338 
339- API key များကို ဒေတာဗေ့စ် သို့ မှတ်သား မထားသင့်ပါ
340- `.env` ဖိုင်များ အသုံးပြုပါ ( `.gitignore` ထဲမှာ ရှိပြီး)
341- သက်ဆိုင်ရာ ပရောဂျက် README များတွင် လိုအပ်သည့် environment variables များ ဖော်ပြထားပါ
342 
343### Python Projects
344 
345- Virtual environment အသုံးပြုပါ: `python -m venv venv`
346- dependency များကို Update လုပ်ထားပါ
347- GitHub tokens များကို လိုအပ်သည့် ခွင့်ပြုချက် နည်းဆုံး သတ်မှတ်ပါ
348 
349### GitHub Models Access
350 
351- GitHub Models သုံးရန် Personal Access Tokens (PAT) လိုအပ်ပါသည်
352- tokens များကို environment variables အဖြစ် လျှို့ဝှက်ထားပါ
353- tokens သို့မဟုတ် စကားဝှက်များကို မည်သည့်အချိန်တွင်မဆို commit မပြုလုပ်ရပါ
354 
355## Additional Notes
356 
357### Target Audience
358 
359- ဝဘ်ဒီဗလပ်မှန်အခြေခံသူ အသစ်စိတ် ပြုလုပ်သူများ
360- ကျောင်းသားများနှင့် ကိုယ်တိုင်လေ့လာသူများ
361- သင်တန်းကျောင်းများ၌ သင်ကြားသူများ
362- ဤ content များသည် လွယ်ကူမြန်ဆန် ရှဉ့်ချိန်နှင့် အဆင့်လိုက်ကျွမ်းကျင်မှုတိုးတက်စေခြင်းအတွက် အထူးပြု ဒီဇိုင်းဖြစ်သည်
363 
364### Educational Philosophy
365 
366- စီမံကိန်း အခြေပြု သင်ကြားမှု နည်းလမ်း
367- မကြာခဏ ဉာဏ်စမ်း စစ်ဆေးမှုများ (စာမေးပွဲများ)
368- လက်တွေ့ ကုဒ် ရေးခွင့်များ
369- လက်တွေ့ ကမ္ဘာဆိုင်ရာ အသုံးချမှု နမူနာများ
370- Framework မတိုင်မှီ အခြေခံကို အားပေးခြင်း
371 
372### Repository Maintenance
373 
374- လေ့လာသင်ယူသူများနှင့် ဆောင်ရွက်သူများ စည်းလုံးညီညွတ်မှုရှိ
375- အမြဲတမ်း dependency လေးစားမှု နှင့် အကြောင်းအရာ အပ်ဒိတ်များ
376- ပြဿနာများနှင့် ဆွေးနွေးမှုများကို maintainers က ထိန်းသိမ်းကြည့်ရှု
377- ဘာသာပြန်မှုများကို GitHub Actions ဖြင့် အလိုအလျောက် ပြုလုပ်သည်
378 
379### Related Resources
380 
381- [Microsoft Learn modules](https://docs.microsoft.com/learn/)
382- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
383- သင်ယူသူများအတွက် အကြံပြုချက် - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
384- အပို သင်တန်းများ: Generative AI, Data Science, ML, IoT သင်ရိုးညွှန်းလမ်းကြောင်းများ ရရှိနိုင်သည်
385 
386### Working with Specific Projects
387 
388အသေးစိတ် လမ်းညွှန်ချက်များအတွက် အောက်ဖော်ပြပါ README ဖိုင်များကို ကြည့်ပါ -
389- `quiz-app/README.md` - Vue 3 quiz application
390- `7-bank-project/README.md` - Banking application with authentication
391- `5-browser-extension/README.md` - Browser extension development
392- `6-space-game/README.md` - Canvas-based game development
393- `9-chat-project/README.md` - AI chat assistant project
394 
395### Monorepo Structure
396 
397ဤဒေတာဗေ့စ်သည် ပုံမှန် Monorepo မဟုတ်ပေမဲ့ အဓိက တစ်နေရာတည်းတွင် ပရောဂျက်များစွာ ရှိပါသည် -
398- သင်ခန်းစာ တစ်ခုချင်းစီ သီးခြားဖြစ်သည်
399- ပရောဂျက်များသည် dependency များ မမျှဝေပါ
400- တစ်ခုချင်းပရောဂျက်များအပေါ် လုပ်ကိုင်ရန် မတူညီသော အတွေ့အကြုံ မပျက်စီးပါ
401- စတင်လေ့လာမှုအတွက် ဒေတာဗေ့စ် အားလုံး clone လုပ်ပါ
402 
403---
404 
405<!-- CO-OP TRANSLATOR DISCLAIMER START -->
406**ကြေညာချက်**:  
407ဤစာတမ်းကို AI ဘာသာပြန်ခြင်းဝန်ဆောင်မှု [Co-op Translator](https://github.com/Azure/co-op-translator) မှ အသုံးပြုပြီး ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် တိကျမှုအတွက် ကြိုးပမ်းနေသော်လည်း၊ အလိုအလျောက် ဘာသာပြန်ချက်များတွင် အမှားများ သို့မဟုတ် တိကျမှု လျော့နည်းချက်များ ရှိနိုင်သည်ကို သတိပြုပါ။ မူရင်းစာတမ်းကို မူရင်းဘာသာဖြင့်သာ စံချိန်စံညွှန်းအားဖြင့် သတ်မှတ်သင့်ပါသည်။ အရေးကြီးသော အချက်အလက်များအတွက်တော့ ပညာရှင်လူ့ဘာသာပြန်ခြင်းကို အကြံပြုပါသည်။ ဤဘာသာပြန်ချက် အသုံးပြုမှုကြောင့် ဖြစ်ပေါ်နိုင်သည့် မတိကျမှုများ သို့မဟုတ် နားမလည်မှုများအတွက် ကျွန်ုပ်တို့၏ တာဝန်မရှိပါကြောင်း အသိပေးအပ်ပါသည်။
408<!-- CO-OP TRANSLATOR DISCLAIMER END -->

Commands it names

git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
npm install
npm run dev
npm run build
npm run lint
npm start
npm run format
pip install openai
python api.py
node server.js
npm run convert
npm install -g docsify-cli
git clone --depth 1
python -m venv venv

Sections

AGENTS.md
Project Overview
Key Components
Architecture
Setup Commands
Main Repository Setup
Quiz App Setup (Vue 3 + Vite)
Bank Project API (Node.js + Express)
Browser Extension Projects
ဘရောက်ဇာအသီးသီးထည့်သွင်းနည်းလမ်းညွှန်များကိုလိုက်နာပါ
Space Game Projects
index.html ကို browser မှာဖွင့်ပါ သို့မဟုတ် Live Server ကိုအသုံးပြုပါ
Chat Project (Python Backend)
GITHUB_TOKEN ပတ်ဝန်းကျင်အပြောင်းအလဲ ကို သတ်မှတ်ပါ
Development Workflow
For Content Contributors
For Learners
Live Development
Testing Instructions
Quiz App Testing
Bank API Testing
General Testing Approach
Pre-submission Checks
Code Style Guidelines
JavaScript
HTML/CSS
Python
Markdown Documentation
File Organization
Build and Deployment
Quiz App Deployment (Azure Static Web Apps)
main ထိ တင်သွင်းသောအခါ GitHub Actions workflow ဖြင့် တင်စစ်သည်။
Documentation PDF Generation
Docsify Documentation
Project-specific Builds
Pull Request Guidelines
Title Format
Required Checks
Contribution Requirements
Review Process
Translation System
Automated Translation
Adding Manual Translation Improvements
Translation Metadata
Debugging and Troubleshooting
Common Issues
Development Environment Tips
Performance Considerations
Security Considerations
Environment Variables
Python Projects
GitHub Models Access
Additional Notes
Target Audience
Educational Philosophy
Repository Maintenance
Related Resources
Working with Specific Projects
Monorepo Structure

What it covers

setup build test lint-format code-style architecture git-pr security api ui performance monorepo agent-behaviour docs

Stack — with the evidence

javascript

(1.00)

github-actions

(0.60)

node

(0.50)

Format

AGENTS.md

A plain-markdown README for coding agents, deliberately unopinionated: no frontmatter, no globs, no vendor keys. That minimalism is why it became the one file a dozen different agents will read, and why it carries the least per-file targeting power of any format here.

What the corpus says about it

Repository

Owner: microsoft
Language: —
License: —
Archived: no

All configs in this repo

Also in microsoft/Web-Dev-For-Beginners

Diff this repo’s formats

One repository carrying more than one format is the comparison this product exists for: does anyone actually write different content in each file, or is one a copy of the other?

The other instruction files in this repository
Repository	Format	Stack	Covers	Score	Changed
microsoft/Web-Dev-For-Beginnerstranslations/zh-TW/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+3	82/100	3 days ago
microsoft/Web-Dev-For-BeginnersAGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildtestlint-format+11	88/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/hi/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatapi+1	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/km/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+3	82/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/zh-HK/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildtestlint-format+10	89/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/kn/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatapi+1	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/ko/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatapi+1	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/lt/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildtestlint-format+4	78/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/ml/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatapi+2	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/ar/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatapi+2	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/bg/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+3	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/bn/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatapi+1	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/cs/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+3	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/da/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildtestlint-format+5	78/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/de/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatstyle+6	78/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/el/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+3	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/en/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildtestlint-format+11	88/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/es/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+3	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/et/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+3	74/100	3 days ago
microsoft/Web-Dev-For-Beginnerstranslations/fa/AGENTS.md · 96k	AGENTS.md	javascriptgithub-actions+1	setupbuildlint-formatgit+2	74/100	3 days ago

Similar configs

Same format, overlapping stack, ranked by quality.

Same format, overlapping stack, ranked by quality
Repository	Format	Stack	Covers	Score	Changed
OnlyTerp/prompt-cache-skillsAGENTS.md · 112	AGENTS.md	pythongithub-actions	setupbuildtestlint-format+5	100/100	3 days ago
n8n-io/n8npackages/@n8n/agents/AGENTS.md · 199k	AGENTS.md	typescriptlangchain+16	buildteststylearch+3	100/100	3 days ago
duckduckgo/content-scope-scriptsspecial-pages/AGENTS.md · 70	AGENTS.md	typescriptjavascript+5	buildteststylearch+3	100/100	3 days ago
wpscanteam/wpscanAGENTS.md · 9.7k	AGENTS.md	rubyvue+3	setupbuildteststyle+6	100/100	2 days ago
SkeneTechnologies/skene-cookbookAGENTS.md · 51	AGENTS.md	pythoneslint+4	setupbuildtestlint-format+7	100/100	2 days ago
mui/material-uiAGENTS.md · 99k	AGENTS.md	typescriptjavascript+13	setupbuildtestlint-format+9	100/100	3 days ago
trick77/agents-md-syncAGENTS.md · 2	AGENTS.md	typescriptnode+4	setupbuildteststyle+5	100/100	3 days ago
aaif-goose/gooseAGENTS.md · 52k	AGENTS.md	rusttypescript+2	setupbuildtestlint-format+6	100/100	3 days ago