Security-101 / mr

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

## प्रकल्पाचा आढावा

**Security-101** हे Microsoft द्वारे तयार केलेले एक सुरुवातीसाठी सुलभ सायबरसुरक्षा अभ्यासक्रम आहे. हा प्रकल्प एक दस्तऐवज-आधारित शिक्षण संसाधन आहे जो संरचित मॉड्यूल्सद्वारे मूलभूत सायबरसुरक्षा संकल्पना शिकवतो. हे विक्रेता-निरपेक्ष आहे आणि लहान धड्यांमध्ये (प्रत्येक 30-60 मिनिटे) पूर्ण करण्यासाठी डिझाइन केलेले आहे.

**मुख्य तंत्रज्ञान:**
- सामग्रीसाठी Markdown
- Docsify साठी स्थिर साइट निर्मिती
- GitHub Pages साठी होस्टिंग
- Co-op Translator साठी बहुभाषिक समर्थन (50+ भाषा)
- GitHub Actions साठी CI/CD

**आर्किटेक्चर:**
- शैक्षणिक सामग्री 8 मुख्य मॉड्यूल्समध्ये आयोजित, प्रत्येकामध्ये उप-पाठ
- 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
```

### सामग्री संरचना

मॉड्यूल्स क्रमांकानुसार क्रमांकित आहेत:
- **मॉड्यूल 1:** मूलभूत सुरक्षा संकल्पना (1.1-1.7)
- **मॉड्यूल 2:** ओळख आणि प्रवेश व्यवस्थापन (2.1-2.4)
- **मॉड्यूल 3:** नेटवर्क सुरक्षा (3.1-3.4)
- **मॉड्यूल 4:** सुरक्षा ऑपरेशन्स (4.1-4.4)
- **मॉड्यूल 5:** अनुप्रयोग सुरक्षा (5.1-5.3)
- **मॉड्यूल 6:** पायाभूत सुविधा सुरक्षा (6.1-6.3)
- **मॉड्यूल 7:** डेटा सुरक्षा (7.1-7.3)
- **मॉड्यूल 8:** AI सुरक्षा (8.1-8.4)

प्रत्येक मॉड्यूल एका क्विझ फाइलसह संपते (उदा., "1.7 End of module quiz.md").

### सामग्री बदल करणे

1. Markdown फाइल्स थेट मूळ डिरेक्टरीमध्ये संपादित करा
2. विद्यमान नाव देण्याच्या पद्धतीचे अनुसरण करा: `[module].[lesson] [Title].md`
3. मॉड्यूल्स जोडणे/काढणे असल्यास README.md टेबल अपडेट करा
4. प्रतिमा `/images/` डिरेक्टरीमध्ये जोडा
5. प्रतिमा सापेक्ष पथांचा वापर करून संदर्भित करा: `![Description](../../translated_images/filename.8c8067c683396b6f17b14be6dc5b8b323f661a863de696f36ec51e4813657b57.mr.png)`

## भाषांतर कार्यप्रवाह

**स्वयंचलित भाषांतर:**
- भाषांतर Co-op Translator GitHub Action द्वारे स्वयंचलितपणे हाताळले जाते
- जेव्हा तुम्ही `main` शाखेत बदल पुश करता, तेव्हा कार्यप्रवाह सामग्री 50+ भाषांमध्ये भाषांतरित करतो
- भाषांतरित फाइल्स `/translations/[language_code]/` मध्ये संग्रहित केल्या जातात
- YAML फ्रंटमॅटरमध्ये भाषांतर मेटाडेटा संरक्षित आहे

**समर्थित भाषा:** अरबी, बंगाली, बल्गेरियन, बर्मी, चिनी (साधी, पारंपरिक), क्रोएशियन, चेक, डॅनिश, डच, एस्टोनियन, फिनिश, फ्रेंच, जर्मन, ग्रीक, हिब्रू, हिंदी, हंगेरियन, इंडोनेशियन, इटालियन, जपानी, कोरियन, लिथुआनियन, मले, मराठी, नेपाळी, नॉर्वेजियन, पर्शियन, पोलिश, पोर्तुगीज, पंजाबी, रोमानियन, रशियन, सर्बियन, स्लोव्हाक, स्लोव्हेनियन, स्पॅनिश, स्वाहिली, स्वीडिश, टागालोग, तमिळ, थाई, तुर्की, युक्रेनियन, उर्दू, व्हिएतनामी आणि अधिक.

**भाषांतर फाइल्स मॅन्युअली संपादित करू नका** - त्या स्वयंचलित कार्यप्रवाहाद्वारे अधिलिखित केल्या जातील.

## कोड शैली मार्गदर्शक तत्त्वे

### Markdown पद्धती

- मानक Markdown सिंटॅक्स वापरा
- शीर्षके: मुख्य शीर्षकासाठी `#`, विभागांसाठी `##`, उपविभागांसाठी `###` वापरा
- यादी: अनऑर्डर्ड यादीसाठी `-` किंवा `*`, ऑर्डर्ड यादीसाठी `1.` वापरा
- दुवे: वर्णनात्मक मजकूरासह GitHub URLs वापरा
- प्रतिमा: `/images/` डिरेक्टरीमध्ये संग्रहित करा, वर्णनात्मक alt मजकूर वापरा
- कोड ब्लॉक्स: लागू असल्यास भाषा आयडेंटिफायरसह ट्रिपल बॅकटिक्स वापरा

### सामग्री मार्गदर्शक तत्त्वे

- धडे लक्ष केंद्रित आणि संक्षिप्त ठेवा (30-60 मिनिटे वाचन वेळ)
- स्पष्ट, सुरुवातीसाठी सुलभ भाषा वापरा
- विक्रेता-विशिष्ट साधन सूचना टाळा (अभ्यासक्रम विक्रेता-निरपेक्ष आहे)
- प्रत्येक मॉड्यूलच्या सुरुवातीला शिक्षण उद्दिष्टे समाविष्ट करा
- 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 फाइल्सचे 50+ भाषांमध्ये स्वयंचलित भाषांतर

**आवश्यक पर्यावरणीय व्हेरिएबल्स:**
- Azure AI सेवा क्रेडेन्शियल्स (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: [Module/Lesson] - [संक्षिप्त वर्णन]`
- `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.mr.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. Markdown योग्यरित्या प्रस्तुत होते याची खात्री करण्यासाठी **स्थानिक स्तरावर चाचणी करा**
5. **स्पष्ट वर्णनासह पुल विनंती सबमिट करा**
6. देखरेख करणार्‍यांकडून **प्रतिक्रिया देणे**

## सामान्य समस्या आणि समस्या निवारण

### भाषांतर कार्य करत नाही

- बदल `main` शाखेत पुश केले आहेत याची खात्री करा
- GitHub Actions टॅबमध्ये कार्यप्रवाह स्थिती तपासा
- भाषांतर कार्यप्रवाह गुपिते कॉन्फिगर केलेली आहेत याची पडताळणी करा
- भाषांतर स्वयंचलितपणे होते; भाषांतर फाइल्स मॅन्युअली संपादित करू नका

### प्रतिमा लोड होत नाहीत

- प्रतिमा पथ फॉरवर्ड स्लॅशेस वापरते याची पडताळणी करा: `images/filename.png`
- प्रतिमा फाइल रिपॉझिटरीमध्ये कमिट केली आहे याची खात्री करा
- प्रतिमा फाइलचे नाव अचूकपणे जुळते (केस-संवेदनशील)
- सापेक्ष पथ वापरा, पूर्ण URLs नाही

### Docsify प्रस्तुत होत नाही

- `index.html` मूळ डिरेक्टरीमध्ये आहे याची खात्री करा
- Docsify CDN दुवे प्रवेशयोग्य आहेत याची पडताळणी करा
- Markdown फाइल्स मानक सिंटॅक्स वापरतात याची खात्री करा
- ब्राउझर कन्सोलमध्ये JavaScript त्रुटी तपासा

### दुवे कार्य करत नाहीत

- धड्यांमधील संदर्भांसाठी पूर्ण GitHub URLs वापरा
- स्वरूप: `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) वापरून भाषांतरित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपयास लक्षात ठेवा की स्वयंचलित भाषांतरांमध्ये त्रुटी किंवा अचूकतेचा अभाव असू शकतो. मूळ भाषेतील दस्तऐवज हा अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी, व्यावसायिक मानवी भाषांतराची शिफारस केली जाते. या भाषांतराचा वापर करून उद्भवलेल्या कोणत्याही गैरसमज किंवा चुकीच्या अर्थासाठी आम्ही जबाबदार राहणार नाही.