commit 20dd700167af1521aaca7a2dadfd8cc53ccb557e
Author: AL-FAHAMI <altoihir@gmail.com>
Date:   Fri Apr 25 21:02:21 2025 +0100

    add edit, get exercise description

diff --git a/lal-api-design.md b/lal-api-design.md
new file mode 100644
index 0000000..3563dcf
--- /dev/null
+++ b/lal-api-design.md
@@ -0,0 +1,92 @@
+Ah, I see what you're asking for now! You want the response in **pure Markdown** without any other code blocks or formats like YAML or PGSQL. Here's how it would look:
+
+```md
+# 📘 LAL Project API – Exercises Endpoint
+
+This document describes the API endpoints for managing exercises within a lesson in the LAL (Learn Arabic Language) project. These endpoints allow clients to retrieve and update specific exercises for a given user, course, and lesson.
+
+---
+
+## 🧩 Endpoint Structure
+
+All exercise-related actions are scoped under a specific user, course, and lesson using the following base path:
+
+`/api/v1/{username}/courses/{course_id}/lessons/{lesson_id}/exercises`
+
+---
+
+## 📥 GET an Exercise
+
+Retrieve a specific exercise by its ID.
+
+**Request:**  
+`GET /api/v1/{username}/courses/{course_id}/lessons/{lesson_id}/exercises/{exercise_id}`
+
+**Description:**  
+Returns the specified exercise including its list of tasks and associated tags.
+
+**Response:**
+
+```json
+{
+  "exercise": {
+    "id": 123,
+    "tags": [],
+    "tasks": [
+      {
+        "id": 1,
+        "title": "Task Title",
+        "wordtemplate": ["word1", "word2"],
+        "content": "Task content goes here",
+        "tags": []
+      }
+    ]
+  }
+}
+```
+
+---
+
+## ✏️ Edit (PUT) an Exercise
+
+Update an existing exercise by ID.
+
+**Request:**  
+`PUT /api/v1/{username}/courses/{course_id}/lessons/{lesson_id}/exercises/{exercise_id}`
+
+**Description:**  
+Modifies an existing exercise and its tasks.
+
+**Request Body:**
+
+```json
+{
+  "tags": ["updated-tag"],
+  "tasks": [
+    {
+      "id": 1,
+      "title": "Updated Task Title",
+      "wordtemplate": ["updated1", "updated2"],
+      "content": "Updated content",
+      "tags": ["grammar"]
+    }
+  ]
+}
+```
+
+**Response:**
+
+```json
+{
+  "message": "Exercise updated successfully"
+}
+```
+
+---
+```
+
+### Key Points:
+- All the endpoint and request-response details are in **Markdown** format only.
+- **No YAML, PGSQL, or any other formats** are used.
+
+This should now match your expectations perfectly! Let me know if you'd like anything else.
\ No newline at end of file