Security-101 / bn

<!--
CO_OP_TRANSLATOR_METADATA:
{
  "original_hash": "913da05fee7fb78699c0447cf6d8aa10",
  "translation_date": "2025-10-12T09:30:20+00:00",
  "source_file": "AGENTS.md",
  "language_code": "bn"
}
-->
# AGENTS.md

## প্রকল্পের সংক্ষিপ্ত বিবরণ

**Security-101** হলো Microsoft দ্বারা তৈরি একটি নবীন-বান্ধব সাইবার নিরাপত্তা পাঠক্রম। এই প্রকল্পটি একটি ডকুমেন্টেশন-ভিত্তিক শিক্ষার উৎস যা গঠনমূলক মডিউলের মাধ্যমে মৌলিক সাইবার নিরাপত্তা ধারণা শেখায়। এটি বিক্রেতা-নিরপেক্ষ এবং ছোট পাঠ (প্রতিটি ৩০-৬০ মিনিট) সম্পন্ন করার জন্য ডিজাইন করা হয়েছে।

**মূল প্রযুক্তি:**
- বিষয়বস্তুর জন্য Markdown
- Docsify স্ট্যাটিক সাইট তৈরির জন্য
- GitHub Pages হোস্টিংয়ের জন্য
- Co-op Translator বহু-ভাষার সমর্থনের জন্য (৫০+ ভাষা)
- GitHub Actions CI/CD এর জন্য

**স্থাপত্য:**
- শিক্ষামূলক বিষয়বস্তু ৮টি প্রধান মডিউলে সংগঠিত, প্রতিটি মডিউলে উপ-পাঠ রয়েছে
- Docsify Markdown বিষয়বস্তু রেন্ডার করার জন্য স্ট্যাটিক HTML সাইট
- Azure AI পরিষেবাগুলির মাধ্যমে স্বয়ংক্রিয় অনুবাদ কর্মপ্রবাহ
- মূল বিষয়বস্তুর জন্য কোনো বিল্ড টুল বা প্যাকেজ ম্যানেজার প্রয়োজন নেই

## রিপোজিটরি কাঠামো

```
/
├── README.md                    # Main entry point with curriculum overview
├── index.html                   # Docsify site entry point
├── [1-8].[1-4] *.md            # Curriculum modules and lessons
├── CODE_OF_CONDUCT.md          # Community guidelines
├── SECURITY.md                 # Security policy
├── SUPPORT.md                  # Support information
├── LICENSE                     # MIT License
├── images/                     # Image assets for lessons
├── translated_images/          # Translated image assets
├── translations/               # Translated versions (50+ languages)
└── .github/
    ├── workflows/
    │   ├── co-op-translator.yml    # Automated translation workflow
    │   ├── deploy.yaml             # GitHub Pages deployment
    │   └── jekyll-gh-pages.yml     # Jekyll site generation
    └── ISSUE_TEMPLATE/             # Issue templates
```

## সেটআপ কমান্ড

এটি একটি ডকুমেন্টেশন প্রকল্প, যেখানে কোনো নির্ভরতা ইনস্টল করার প্রয়োজন নেই। বিষয়বস্তু নিয়ে কাজ করতে:

```bash
# Clone the repository
git clone https://github.com/microsoft/Security-101.git
cd Security-101

# View content locally - any Markdown viewer works
# OR serve with a simple HTTP server to use Docsify rendering
python -m http.server 8000
# Then visit http://localhost:8000 in your browser
```

## উন্নয়ন কর্মপ্রবাহ

### স্থানীয়ভাবে বিষয়বস্তু দেখা

প্রকল্পটি Docsify ব্যবহার করে রেন্ডারিং করে। পরিবর্তনগুলি প্রিভিউ করতে:

```bash
# Option 1: Use Python's built-in HTTP server
python -m http.server 8000

# Option 2: Use Node.js http-server (if available)
npx http-server -p 8000

# Option 3: View Markdown files directly in any Markdown editor
```

### বিষয়বস্তুর কাঠামো

মডিউলগুলি ক্রমানুসারে নম্বরযুক্ত:
- **মডিউল ১:** মৌলিক নিরাপত্তা ধারণা (১.১-১.৭)
- **মডিউল ২:** পরিচয় ও প্রবেশাধিকার ব্যবস্থাপনা (২.১-২.৪)
- **মডিউল ৩:** নেটওয়ার্ক নিরাপত্তা (৩.১-৩.৪)
- **মডিউল ৪:** নিরাপত্তা কার্যক্রম (৪.১-৪.৪)
- **মডিউল ৫:** অ্যাপ্লিকেশন নিরাপত্তা (৫.১-৫.৩)
- **মডিউল ৬:** অবকাঠামো নিরাপত্তা (৬.১-৬.৩)
- **মডিউল ৭:** ডেটা নিরাপত্তা (৭.১-৭.৩)
- **মডিউল ৮:** AI নিরাপত্তা (৮.১-৮.৪)

প্রতিটি মডিউলের শেষে একটি কুইজ ফাইল থাকে (যেমন, "১.৭ End of module quiz.md")।

### বিষয়বস্তু পরিবর্তন করা

1. মূল ডিরেক্টরিতে Markdown ফাইলগুলি সরাসরি সম্পাদনা করুন
2. বিদ্যমান নামকরণের নিয়ম অনুসরণ করুন: `[module].[lesson] [Title].md`
3. মডিউল যোগ বা অপসারণ করলে README.md টেবিল আপডেট করুন
4. `/images/` ডিরেক্টরিতে ছবি যোগ করুন
5. আপেক্ষিক পথ ব্যবহার করে ছবি উল্লেখ করুন: `![Description](../../translated_images/filename.8c8067c683396b6f17b14be6dc5b8b323f661a863de696f36ec51e4813657b57.bn.png)`

## অনুবাদ কর্মপ্রবাহ

**স্বয়ংক্রিয় অনুবাদ:**
- অনুবাদগুলি Co-op Translator GitHub Action দ্বারা স্বয়ংক্রিয়ভাবে পরিচালিত হয়
- যখন আপনি `main` শাখায় পরিবর্তনগুলি পুশ করেন, কর্মপ্রবাহ বিষয়বস্তু ৫০+ ভাষায় অনুবাদ করে
- অনুবাদিত ফাইলগুলি `/translations/[language_code]/` ডিরেক্টরিতে সংরক্ষিত হয়
- YAML frontmatter-এ অনুবাদ মেটাডেটা সংরক্ষিত থাকে

**সমর্থিত ভাষা:** আরবি, বাংলা, বুলগেরিয়ান, বার্মিজ, চীনা (সরলীকৃত, ঐতিহ্যবাহী), ক্রোয়েশিয়ান, চেক, ড্যানিশ, ডাচ, এস্তোনিয়ান, ফিনিশ, ফরাসি, জার্মান, গ্রীক, হিব্রু, হিন্দি, হাঙ্গেরিয়ান, ইন্দোনেশিয়ান, ইতালিয়ান, জাপানি, কোরিয়ান, লিথুয়ানিয়ান, মালয়, মারাঠি, নেপালি, নরওয়েজিয়ান, পার্সিয়ান, পোলিশ, পর্তুগিজ, পাঞ্জাবি, রোমানিয়ান, রাশিয়ান, সার্বিয়ান, স্লোভাক, স্লোভেনিয়ান, স্প্যানিশ, সোয়াহিলি, সুইডিশ, টাগালগ, তামিল, থাই, তুর্কি, ইউক্রেনীয়, উর্দু, ভিয়েতনামি এবং আরও অনেক।

**অনুবাদ ফাইলগুলি ম্যানুয়ালি সম্পাদনা করবেন না** - সেগুলি স্বয়ংক্রিয় কর্মপ্রবাহ দ্বারা ওভাররাইট করা হবে।

## কোড স্টাইল নির্দেশিকা

### Markdown নিয়মাবলী

- স্ট্যান্ডার্ড Markdown সিনট্যাক্স ব্যবহার করুন
- শিরোনাম: প্রধান শিরোনামের জন্য `#`, বিভাগের জন্য `##`, উপবিভাগের জন্য `###` ব্যবহার করুন
- তালিকা: আনঅর্ডারড তালিকার জন্য `-` বা `*`, অর্ডারড তালিকার জন্য `1.` ব্যবহার করুন
- লিঙ্ক: বর্ণনামূলক পাঠ্য ব্যবহার করে পূর্ণ GitHub URL ব্যবহার করুন
- ছবি: `/images/` ডিরেক্টরিতে সংরক্ষণ করুন, বর্ণনামূলক alt টেক্সট ব্যবহার করুন
- কোড ব্লক: প্রযোজ্য হলে ভাষার শনাক্তকারী সহ ট্রিপল ব্যাকটিক ব্যবহার করুন

### বিষয়বস্তু নির্দেশিকা

- পাঠগুলি সংক্ষিপ্ত এবং কেন্দ্রীভূত রাখুন (৩০-৬০ মিনিটের পড়ার সময়)
- পরিষ্কার, নবীন-বান্ধব ভাষা ব্যবহার করুন
- বিক্রেতা-নির্দিষ্ট টুল নির্দেশিকা এড়িয়ে চলুন (পাঠক্রমটি বিক্রেতা-নিরপেক্ষ)
- প্রতিটি মডিউলের শুরুতে শিক্ষার উদ্দেশ্য অন্তর্ভুক্ত করুন
- প্রাসঙ্গিক Microsoft Learn রিসোর্সের লিঙ্ক দিন
- বিষয়বস্তু শিক্ষামূলক, প্রচারমূলক নয় তা নিশ্চিত করুন

### ফাইল নামকরণ

- ফরম্যাট ব্যবহার করুন: `[Module].[Lesson] [Title].md`
- উদাহরণ: `1.1 The CIA triad and other key concepts.md`
- কুইজ ফাইল: `[Module].[Last] End of module quiz.md`
- ফাইল নামের মধ্যে স্পেস ব্যবহার করুন (বিদ্যমান নিয়ম অনুসারে)

## GitHub কর্মপ্রবাহ

### Co-op Translator (co-op-translator.yml)

**ট্রিগার:** `main` শাখায় পুশ  
**উদ্দেশ্য:** নতুন/পরিবর্তিত Markdown ফাইলগুলি ৫০+ ভাষায় স্বয়ংক্রিয়ভাবে অনুবাদ করে

**প্রয়োজনীয় পরিবেশ ভেরিয়েবল:**
- Azure AI Service শংসাপত্র (AZURE_AI_SERVICE_API_KEY, AZURE_AI_SERVICE_ENDPOINT)
- Azure OpenAI শংসাপত্র (ঐচ্ছিক বিকল্প)
- OpenAI শংসাপত্র (ঐচ্ছিক বিকল্প)

### Deploy (deploy.yaml)

**ট্রিগার:** README.md পরিবর্তন হলে `main` শাখায় পুশ  
**উদ্দেশ্য:** GitHub Pages-এ স্ট্যাটিক সাইট ডিপ্লয় করে  
**আউটপুট:** GitHub Pages সাইট আপডেট করে

### Jekyll GitHub Pages (jekyll-gh-pages.yml)

**ট্রিগার:** কনফিগার করা শাখায় পুশ  
**উদ্দেশ্য:** Jekyll ব্যবহার করে সাইট তৈরি এবং ডিপ্লয় করে

## পুল রিকোয়েস্ট নির্দেশিকা

### জমা দেওয়ার আগে

1. **বিষয়বস্তু পর্যালোচনা:** সাইবার নিরাপত্তা ধারণাগুলির সঠিকতা এবং স্পষ্টতা নিশ্চিত করুন
2. **ফরম্যাটিং:** Markdown ফরম্যাটিং সঠিকভাবে রেন্ডার হয় তা যাচাই করুন
3. **লিঙ্ক:** সমস্ত অভ্যন্তরীণ এবং বাহ্যিক লিঙ্ক পরীক্ষা করুন
4. **ছবি:** নিশ্চিত করুন যে সমস্ত ছবি লোড হয় এবং বর্ণনামূলক alt টেক্সট রয়েছে
5. **সঙ্গতি:** বিদ্যমান বিষয়বস্তু কাঠামো এবং শৈলী অনুসরণ করুন

### PR শিরোনাম ফরম্যাট

বর্ণনামূলক শিরোনাম ব্যবহার করুন:
- `Add: [নতুন বিষয়বস্তু বর্ণনা]`
- `Update: [মডিউল/পাঠ] - [সংক্ষিপ্ত বর্ণনা]`
- `Fix: [সমস্যার বর্ণনা]`
- `Docs: [ডকুমেন্টেশন পরিবর্তন]`

### প্রয়োজনীয় চেক

- বিষয়বস্তু সঠিকতা (ম্যানুয়াল পর্যালোচনা)
- Markdown ফরম্যাটিং যাচাই
- লিঙ্ক যাচাই
- অনুবাদ কর্মপ্রবাহ সম্পন্ন (`main` শাখার মার্জের জন্য)

### পর্যালোচনা প্রক্রিয়া

1. অন্তত একজন রক্ষণাবেক্ষণকারী পর্যালোচনা প্রয়োজন
2. সাইবার নিরাপত্তা ধারণাগুলির প্রযুক্তিগত সঠিকতার উপর মনোযোগ দিন
3. অ্যাক্সেসযোগ্যতা এবং নবীন-বান্ধবতা যাচাই করুন
4. বিক্রেতা নিরপেক্ষতা বজায় রাখা নিশ্চিত করুন

## সাধারণ কাজ

### নতুন পাঠ যোগ করা

```bash
# 1. Create new Markdown file with proper naming
touch "[Module].[Lesson] [Title].md"

# 2. Add content following template structure
# 3. Update README.md module table with new entry
# 4. Add entry to module overview table
# 5. Ensure quiz file numbering is correct

# 6. Commit changes
git add "[Module].[Lesson] [Title].md" README.md
git commit -m "Add: [Module].[Lesson] - [Title]"
git push
```

### বিদ্যমান বিষয়বস্তু আপডেট করা

```bash
# 1. Edit the relevant Markdown file
# 2. Verify formatting and links
# 3. Commit with descriptive message
git add "[Module].[Lesson] [Title].md"
git commit -m "Update: [Module].[Lesson] - [Brief description of changes]"
git push
```

### ছবি যোগ করা

```bash
# 1. Add image to /images/ directory
cp new-image.png images/

# 2. Reference in Markdown
# ![Descriptive alt text](../../translated_images/new-image.ade387a7c819665dda19f7585b9b1cc82817a21d283e286f39c2891d201fcdab.bn.png)

# 3. Commit both content and image
git add "images/new-image.png" "[Module].[Lesson] [Title].md"
git commit -m "Add: Image for [description]"
git push
```

## পরীক্ষা এবং যাচাই

### বিষয়বস্তু যাচাই

এটি একটি ডকুমেন্টেশন প্রকল্প হওয়ায়, পরীক্ষার ফোকাস নিম্নলিখিত বিষয়ে:

1. **Markdown রেন্ডারিং:** Docsify ব্যবহার করে স্থানীয়ভাবে পরিবর্তনগুলি দেখুন
2. **লিঙ্ক যাচাই:** সমস্ত লিঙ্ক ম্যানুয়ালি ক্লিক করুন
3. **ছবি লোডিং:** নিশ্চিত করুন যে সমস্ত ছবি সঠিকভাবে প্রদর্শিত হয়
4. **অনুবাদ:** নিশ্চিত করুন যে ফাইলগুলি অনুবাদক কর্মপ্রবাহ দ্বারা গ্রহণ করা হয়েছে (স্বয়ংক্রিয়)
5. **অ্যাক্সেসযোগ্যতা:** সঠিক শিরোনাম শ্রেণিবিন্যাস এবং alt টেক্সট নিশ্চিত করুন

### স্থানীয় প্রিভিউ

```bash
# Serve locally to test Docsify rendering
python -m http.server 8000

# Visit http://localhost:8000
# Click through navigation to verify all links work
# Check that images load properly
# Verify Markdown formatting renders correctly
```

### প্রি-কমিট চেকলিস্ট

- [ ] Markdown ফাইলগুলি সঠিক সিনট্যাক্স ব্যবহার করে
- [ ] সমস্ত লিঙ্ক বৈধ এবং সম্ভব হলে HTTPS ব্যবহার করে
- [ ] ছবিগুলির বর্ণনামূলক alt টেক্সট রয়েছে
- [ ] বিষয়বস্তু নবীন-বান্ধব এবং সঠিক
- [ ] বিক্রেতা-নিরপেক্ষ ভাষা বজায় রাখা হয়েছে
- [ ] মডিউল যোগ বা অপসারণ করলে README.md আপডেট করা হয়েছে
- [ ] ফাইল নামকরণ নিয়ম অনুসরণ করে

## নিরাপত্তা বিবেচনা

- **বিষয়বস্তুতে কোনো গোপন তথ্য নেই:** API কী, পাসওয়ার্ড বা সংবেদনশীল ডেটা কখনোই কমিট করবেন না
- **লিঙ্ক যাচাই:** নিশ্চিত করুন যে সমস্ত বাহ্যিক লিঙ্ক বিশ্বস্ত উৎসে রয়েছে
- **ছবি বিষয়বস্তু:** নিশ্চিত করুন যে ছবিগুলি সংবেদনশীল তথ্য ধারণ করে না
- **অনুবাদ কর্মপ্রবাহ:** যথাযথ প্রমাণীকরণের সাথে Azure AI পরিষেবাগুলি ব্যবহার করে
- **SECURITY.md:** SECURITY.md-এ দুর্বলতা রিপোর্টিং প্রক্রিয়া অনুসরণ করুন

## অতিরিক্ত রিসোর্স

### সম্পর্কিত Microsoft কোর্স

এই পাঠক্রমটি Microsoft শিক্ষামূলক রিসোর্সের একটি বৃহত্তর সংগ্রহের অংশ:
- নবীনদের জন্য জেনারেটিভ AI
- নবীনদের জন্য AI
- নবীনদের জন্য ডেটা সায়েন্স
- নবীনদের জন্য ML
- নবীনদের জন্য ওয়েব ডেভেলপমেন্ট
- নবীনদের জন্য IoT

### বাহ্যিক শিক্ষার পথ

Security-101 সম্পন্ন করার পরে:
- [Microsoft Security, Compliance, and Identity Fundamentals](https://learn.microsoft.com/training/paths/describe-concepts-of-security-compliance-identity/)
- [Exam SC-900: Microsoft Security, Compliance, and Identity Fundamentals](https://learn.microsoft.com/credentials/certifications/exams/sc-900/)

## অবদান রাখা

1. **GitHub-এ রিপোজিটরি ফর্ক করুন**
2. **আপনার পরিবর্তনের জন্য একটি ফিচার ব্রাঞ্চ তৈরি করুন**
3. **নির্দেশিকা অনুসরণ করে আপনার পরিবর্তন করুন**
4. **স্থানীয়ভাবে পরীক্ষা করুন** যাতে সবকিছু সঠিকভাবে রেন্ডার হয়
5. **পরিবর্তনের একটি পরিষ্কার বর্ণনা সহ একটি পুল রিকোয়েস্ট জমা দিন**
6. **রক্ষণাবেক্ষণকারীদের প্রতিক্রিয়ার উত্তর দিন**

## সাধারণ সমস্যা এবং সমস্যা সমাধান

### অনুবাদ কাজ করছে না

- নিশ্চিত করুন যে পরিবর্তনগুলি `main` শাখায় পুশ করা হয়েছে
- GitHub Actions ট্যাবে কর্মপ্রবাহের স্থিতি পরীক্ষা করুন
- অনুবাদ কর্মপ্রবাহের গোপনীয়তা কনফিগার করা হয়েছে কিনা যাচাই করুন
- অনুবাদ স্বয়ংক্রিয়ভাবে ঘটে; অনুবাদ ফাইলগুলি ম্যানুয়ালি সম্পাদনা করবেন না

### ছবি লোড হচ্ছে না

- নিশ্চিত করুন যে ছবির পথ ফরোয়ার্ড স্ল্যাশ ব্যবহার করে: `images/filename.png`
- নিশ্চিত করুন যে ছবির ফাইল রিপোজিটরিতে কমিট করা হয়েছে
- নিশ্চিত করুন যে ছবির ফাইলের নাম সঠিকভাবে মিলে (কেস-সেনসিটিভ)
- আপেক্ষিক পথ ব্যবহার করুন, সম্পূর্ণ URL নয়

### Docsify রেন্ডারিং করছে না

- নিশ্চিত করুন যে `index.html` মূল ডিরেক্টরিতে উপস্থিত
- Docsify CDN লিঙ্কগুলি অ্যাক্সেসযোগ্য কিনা যাচাই করুন
- নিশ্চিত করুন যে Markdown ফাইলগুলি স্ট্যান্ডার্ড সিনট্যাক্স ব্যবহার করে
- ব্রাউজার কনসোলে JavaScript ত্রুটি পরীক্ষা করুন

### লিঙ্ক কাজ করছে না

- পাঠগুলির মধ্যে ক্রস-রেফারেন্সের জন্য পূর্ণ GitHub URL ব্যবহার করুন
- ফরম্যাট: `https://github.com/microsoft/Security-101/blob/main/[file].md`
- রেন্ডার করা দৃশ্যে লিঙ্কগুলি পরীক্ষা করুন, শুধুমাত্র কাঁচা Markdown-এ নয়

## প্রকল্প রক্ষণাবেক্ষণ

### নিয়মিত কাজ

- সম্প্রদায়ের অবদান পর্যালোচনা এবং মার্জ করুন
- নিরাপত্তা ল্যান্ডস্কেপ পরিবর্তনের সাথে বিষয়বস্তু সঠিকতার জন্য আপডেট করুন
- অনুবাদ কর্মপ্রবাহে ত্রুটি পর্যবেক্ষণ করুন
- সমস্যাগুলি এবং আলোচনা উত্তর দিন
- বাহ্যিক লিঙ্কগুলি আপডেট রাখুন

### সংস্করণ নিয়ন্ত্রণ

- `main` শাখা সুরক্ষিত এবং PR পর্যালোচনা প্রয়োজন
- সমস্ত পরিবর্তন পুল রিকোয়েস্ট প্রক্রিয়ার মাধ্যমে যায়
- অনুবাদ ফাইলগুলি স্বয়ংক্রিয়ভাবে তৈরি হয়, ম্যানুয়ালি সম্পাদনা করবেন না
- অর্থপূর্ণ কমিট বার্তা ব্যবহার করুন

## AI কোডিং এজেন্টদের জন্য নোট

- **এটি একটি ডকুমেন্টেশন প্রকল্প** - বিষয়বস্তু গুণমানের উপর মনোযোগ দিন, কোড নয়
- **অনুবাদ ফাইলগুলি পরিবর্তন করবেন না** - সেগুলি স্বয়ংক্রিয়ভাবে তৈরি হয়
- **ফাইল নামকরণের নিয়মাবলী সংরক্ষণ করুন** - বিদ্যমান প্যাটার্ন অনুযায়ী ফাইল নামের মধ্যে স্পেস ব্যবহার করুন
- **README.md আপডেট করুন** মডিউল যোগ বা অপসারণ করলে টেবিল সিঙ্কে রাখুন
- **PR জমা দেওয়ার আগে স্থানীয়ভাবে পরীক্ষা করুন** যাতে Markdown সঠিকভাবে রেন্ডার হয়
- **বিদ্যমান বিষয়বস্তু শৈলী অনুসরণ করুন** - নবীন-বান্ধব, বিক্রেতা-নিরপেক্ষ টোন বজায় রাখুন
- **কোনো বিল্ড প্রক্রিয়া প্রয়োজন নেই** - স্থানীয় উন্নয়নের জন্য একটি সাধারণ HTTP সার্ভার যথেষ্ট
- **মডিউল কাঠামো সম্মান করুন** - প্রতিটি মডিউলে ধারাবাহিক নম্বর এবং সংগঠন রয়েছে

---

**অস্বীকৃতি**:  
এই নথিটি AI অনুবাদ পরিষেবা [Co-op Translator](https://github.com/Azure/co-op-translator) ব্যবহার করে অনুবাদ করা হয়েছে। আমরা যথাসাধ্য সঠিকতার জন্য চেষ্টা করি, তবে অনুগ্রহ করে মনে রাখবেন যে স্বয়ংক্রিয় অনুবাদে ত্রুটি বা অসঙ্গতি থাকতে পারে। মূল ভাষায় থাকা নথিটিকে প্রামাণিক উৎস হিসেবে বিবেচনা করা উচিত। গুরুত্বপূর্ণ তথ্যের জন্য, পেশাদার মানব অনুবাদ সুপারিশ করা হয়। এই অনুবাদ ব্যবহারের ফলে কোনো ভুল বোঝাবুঝি বা ভুল ব্যাখ্যা হলে আমরা দায়বদ্ধ থাকব না।