Format Guide for Advanced English Lessons (Arabic content)

You are writing advanced-level English lessons for an Arabic-learning website. Follow this EXACT format.

Files to create

For each lesson N with slug foo-bar, create TWO files:

1. content/lessons/advanced/N.foo-bar.md
2. content/lessons/advanced/N.foo-bar.json

IMPORTANT: Files must be written as plain UTF-8 (NO BOM — do not use PowerShell Set-Content; use the Write tool).

.md file structure

Frontmatter (YAML between ---)

---
title: "<Arabic SEO title>"
shortTitle: <short Arabic title, 2-4 words>
order: <N>
description: "<Arabic description sentence(s), quoted string>"
keywords:
  - "<Arabic keyword>"
  - "<English keyword>"
  - "<Arabic keyword>"
  - "<English keyword>"
  - "<Arabic keyword>"
  - "<English keyword>"
  - "<Arabic keyword>"
  - "<English keyword>"
  - "<Arabic keyword>"
  - "<English keyword>"
  - "<Arabic keyword>"
  - "<English keyword>"
vocabulary:
  - word: <English word>
    translation: <Arabic translation>
  # repeat 22 items total
---

CRITICAL: The title: value MUST be wrapped in double quotes because it contains a colon (e.g. "تعلّم ... بالإنجليزية: ..."). Never leave it unquoted — an unquoted : inside YAML breaks the app's parser.

Body content (markdown)

Structure the body like this:

1. Opening ## heading + 2-3 paragraphs introducing the topic. Use backticks around English terms inline, e.g. negotiation (التفاوض). Write in fluent, correct Arabic for an advanced level.

2. Several ## / ### sections covering:

   • Key vocabulary tables: | English | العربية | مثال في جملة | with rows using **bold** for the English word in the example.
   • Grammar/usage blocks.

3. Must include these special code-fence blocks (react-markdown parses them):

NOTE: Use Arabic-Indic numerals ١ ٢ ٣ ٤ in daily situations. Each bullet line has an English phrase in double quotes followed by Arabic translation in parentheses.

.json file structure

An array of exactly 8 quiz questions:

[
  {
    "question": "<Arabic question>",
    "options": ["<option A>", "<option B>", "<option C>", "<option D>"],
    "correctIndex": <index of correct option, 0-3>
  }
]

Questions must test the lesson's vocabulary/grammar. Distractor options must be plausible but wrong. Vary correctIndex across the 8 questions (mix 0,1,2,3).

Arabic quality requirements (CRITICAL)

• Use CORRECT standard Arabic spelling: ي (not ی), ة (not ه), أ/إ/ا correctly, proper hamza placement.
• NO typos, NO garbled/transliterated English mixed into Arabic sentences.
• Vocabulary translations must be accurate and natural Arabic.
• English sentences must be grammatically correct, natural, advanced-level.
• Do not invent quotes: for ```quote use well-known real quotes. If unsure, use a classic, verifiable quote (avoid fabricating attributions).

Reference

Read content/lessons/advanced/7.technical-writing.md and content/lessons/advanced/24.supply-chain.md (and their .json) for exact style and tone before writing.