Update docs

docs/open-edx/course-authors/add-content.md

@@ -22,6 +22,8 @@ Open edX uses a strict hierarchical structure:
    * Click the **"+ Add Section"** button at the bottom of the course outline.
    * Enter a clear title for your section (e.g., *Module 1: Introduction to Renewable Energy*) and press **Enter** or click **Save**.
 
+     ![Course outline with the New section and New subsection buttons](images/add-content/01-outline-new-section-subsection.png)
+
 3. **Add a Subsection (Sequential):**
    * Within your new section, click the **"+ Add Subsection"** button.
    * Enter a descriptive title (e.g., *1.1 Core Concepts*) and save.
@@ -37,12 +39,24 @@ Open edX uses a strict hierarchical structure:
 2. **Open the Unit Editor:**
    * Click on the newly created unit title to open the visual unit editor page.
 
+     ![Unit editor page with the Add a new component panel, Preview button and Publish status panel](images/add-content/02-unit-editor.png)
+
 3. **Add Components (Verawood Layout):**
    * You will see the component toolbar offering options to add content types: **Text**, **Video**, **Problem**, or **Advanced**.
    * Click on **Text** to add rich text, formatted headings, and images.
+
+     ![Text button in the Add a new component panel](images/add-content/03-add-text.png)
+
    * Click on **Video** to configure video lectures, upload subtitles, and set up the video player.
+
+     ![Video button in the Add a new component panel](images/add-content/04-add-video.png)
+
+     ![Video editor with the Video URL field](images/add-content/05-video-url.png)
+
    * Click on **Problem** to insert interactive quizzes or homework questions directly into the page.
 
+     ![Problem editor for a multi-select problem](images/add-content/06-problem-editor.png)
+
 4. **Edit and Preview:**
    * Use the built-in inline editors to format your text or configure component settings.
    * Click the **"Preview"** button at the top right of the unit page at any time to see how the content will appear to learners.
@@ -56,4 +70,6 @@ Open edX uses a strict hierarchical structure:
 2. **Bulk Publishing (Verawood Feature):**
    * You can also publish entire subsections or sections directly from the Course Outline view by clicking the publish icon next to the module header, streamlining the release of weekly content.
 
+     ![Publish option in a section's menu in the course outline](images/add-content/07-publish-from-outline.png)
+
 *Need help? If you experience any issues during registration or login, please reach out to support@abstract-technology.de.*

docs/open-edx/course-authors/cohorts-and-content-groups.md

@@ -37,6 +37,8 @@ Cohorts allow you to group learners (for example, by region, organization, or le
 
    * You can manually assign learners to cohorts via the **Instructor Dashboard** in the live LMS under **Student Management > Cohorts**.
 
+     ![Instructor Dashboard with the Cohorts tab open](images/cohorts-and-content-groups/01-instructor-dashboard-cohorts.png)
+
    * Alternatively, you can configure automated enrollment rules so learners are automatically assigned to specific cohorts based on their registration track or sign-up code.
 
 ## Part 3: Creating and Managing Content Groups
@@ -49,17 +51,25 @@ Content groups allow you to deliver different versions of specific course compon
 2. **Add a Content Group:**
    Click **"Add Content Group"**. Enter a name for the group (e.g., *Advanced Track* or *Enterprise Clients*) and save.
 
+   ![Group Configurations page with the Add your first content group button](images/cohorts-and-content-groups/02-add-content-group.png)
+
 3. **Apply Content Groups to Courseware:**
 
    * Open your **Course Outline** in Studio and navigate to the unit where you want to restrict or customize content.
 
    * Click the **Configure (gear)** icon on a specific component or subsection.
 
+     ![Access Settings (gear) icon of a component on a Studio unit page](images/cohorts-and-content-groups/03-component-access-settings-icon.png)
+
    * Select the **VISIBILITY** tab.
 
    * Under **Accessability / Hide/Show to specific groups**, select the content group that should have access to this component.
 
+     ![Editing access dialog with Content Groups in the Restrict access to dropdown](images/cohorts-and-content-groups/04-restrict-access-content-groups.png)
+
    * Save and publish your changes. Learners outside the assigned content group will not see this specific component.
 
+     ![Message under the component title listing the groups that have access](images/cohorts-and-content-groups/05-access-restriction-indicator.png)
+
 *Need help? If you experience any issues during registration or login, please reach out to support@abstract-technology.de.*
 

docs/open-edx/course-authors/create-a-certificate.md

@@ -43,6 +43,8 @@ Follow this step-by-step guide to set up, configure, and issue digital completio
    * **Course:** Select your specific course from the dropdown list.
    * **Mode:** Choose the certificate type (e.g., `audit`, `verified`, `no-id-professional`, `credit`, `professional`, or `honor`).
    * **Price & Currency:** Set the price and currency if applicable (leave default or zero for free courses).
+
+   ![Django admin course mode form with the Course, Mode, Price and Currency fields](images/create-a-certificate/01-django-admin-add-course-mode.png)
 5. **Save:**  
    Click **"Save"** at the bottom right. Once saved, return to Studio > Settings > Certificates.
 

docs/open-edx/course-authors/create-a-course.md

@@ -20,6 +20,8 @@ Open edX Studio is the authoring environment where educators and course teams bu
 
    * From the Studio dashboard, click the **"+ New Course"** button.
 
+     ![Studio Home with the New Course button](images/create-course/01-studio-home-new-course.png)
+
 2. **Fill in Course Details:**
 
    * Complete the required fields in the modal window:
@@ -28,6 +30,8 @@ Open edX Studio is the authoring environment where educators and course teams bu
      * **Course Number:** A unique code or short identifier (e.g., *RE101*).
      * **Course Run:** The session or semester identifier (e.g., *2026_Q1*).
 
+     ![Create a New Course form with Course Name, Organization, Course Number and Course Run](images/create-course/02-create-new-course-form.png)
+
 3. **Save and Create:**
 
    * Click **"Create"**.
@@ -36,4 +40,6 @@ Open edX Studio is the authoring environment where educators and course teams bu
 
    * Once created, the system will redirect you to the empty course outline in Studio, where you can begin structuring your curriculum, adding chapters, sequential modules, and units.
 
+     ![Course outline in Studio](images/create-course/03-course-outline.png)
+
 *Need help? If you experience any issues during registration or login, please reach out to support@abstract-technology.de.*

docs/open-edx/course-authors/grading-and-assessments.md

@@ -12,22 +12,32 @@ Before creating graded assignments, you need to establish your grading categorie
 
    * In Open edX Studio, open your course and navigate to the top navigation bar. Click on **"Settings"** and select **"Grading"**.
 
+   ![Settings menu in Studio with Grading selected](images/grading-and-assessments/01-settings-grading-menu.png)
+
 2. **Configure Assignment Types (Grading Policy):**
 
    * By default, the platform includes standard categories (e.g., Homework, Lab, Midterm Exam, Final Exam). You can edit these or click **"+ Add Grade Category"** to create new ones (e.g., *Quizzes*, *Participation*).
 
+   ![Assignment types section on the Grading page](images/grading-and-assessments/02-assignment-types.png)
+
 3. **Set Weight Percentages:**
 
    * Assign a percentage weight to each category (e.g., Homework: 30%, Quizzes: 20%, Final Exam: 50%). Note: The total weight across all active categories **must equal 100%**.
 
+   ![How the course grade is calculated from the weighted assignment types](images/grading-and-assessments/03-overall-grade-formula.png)
+
 4. **Define Due Dates and Grace Periods:**
 
    * Set default release and due dates for assignment types, or configure how late submissions are handled.
 
+   ![Grading page with the grace period field](images/grading-and-assessments/04-grace-period.png)
+
 5. **Set the Passing Grade:**
 
    * Scroll down to the **Grade Range** or **Passing Grade** section and enter the minimum percentage required to pass the course (e.g., `60`).
 
+   ![Overall grade range slider with the Pass/Fail threshold](images/grading-and-assessments/05-grade-range.png)
+
 6. **Save Changes:**
 
    * Click the **"Save Changes"** button at the bottom of the page.
@@ -46,12 +56,16 @@ Once your grading categories are set up, you can tag individual problem componen
 
    * In the component toolbar, click on **"Problem"** and choose a question type (e.g., *Multiple Choice*, *Checkboxes*, *Dropdown*, or *Text Response*).
 
+   ![Add New Component panel with the Problem button](images/grading-and-assessments/06-add-new-component-problem.png)
+
 3. **Edit the Assessment:**
 
    * Click **"Edit"** on the problem component to open the XML/Studio problem editor.
 
    * Enter your question prompt, answer choices, and specify the correct answer(s).
 
+   ![Problem editor with question, answers and Scoring settings](images/grading-and-assessments/07-problem-editor.png)
+
 4. **Assign the Problem to a Grading Category:**
 
    * Click **"Settings"** (gear icon) on the problem component wrapper.
@@ -72,4 +86,6 @@ Once your grading categories are set up, you can tag individual problem componen
 
    * Instructors and staff can review learner scores and override grades if necessary via the **Instructor Dashboard** under the **Student Management** or **Grading** tabs.
 
+   ![Edit Grades dialog in the gradebook](images/grading-and-assessments/08-gradebook-edit-grades.png)
+
 *Need help? If you experience any issues during registration or login, please reach out to support@abstract-technology.de.*

docs/open-edx/course-authors/milestones-and-engagement.md

@@ -12,6 +12,8 @@ Follow this guide to activate and configure these features via the Django Admini
 
 When learners complete the first section of a course, a celebratory pop-up modal appears to acknowledge their progress.
 
+![Congratulations pop-up after completing the first section](images/milestones-and-engagement/01-first-section-celebration.png)
+
 1. **Log In to Django Admin:**  
    Log in to your Open edX platform with an administrator account and open the **Django Administration** panel (`https://yourdomain.com/admin/`).
 2. **Navigate to Waffle Flags:**  
@@ -30,6 +32,8 @@ When learners complete the first section of a course, a celebratory pop-up modal
 
 When learners successfully finish an entire course, a congratulatory microfrontend completion page appears.
 
+![Course completion celebration page](images/milestones-and-engagement/02-course-completion-page.png)
+
 1. **Access Django Admin:**  
    Navigate to the **Django Administration** panel.
 2. **Open Waffle Flags:**  
@@ -46,6 +50,8 @@ When learners successfully finish an entire course, a congratulatory microfronte
 
 This feature allows learners to set personal study goals (Casual: 1 day/week, Regular: 3 days/week, or Intense: 5 days/week) and receive automated email reminders if they fall behind schedule.
 
+![Weekly learning goal options with the goal reminder toggle](images/milestones-and-engagement/03-weekly-learning-goals.png)
+
 1. **Access Django Admin:**  
    Go to your **Django Administration** panel.
 2. **Open Waffle Flags:**  
@@ -58,12 +64,16 @@ This feature allows learners to set personal study goals (Casual: 1 day/week, Re
 
 *Note on Automated Reminders:* Depending on the learner's chosen goal frequency, automated reminder emails are dispatched prior to the end of the week (Sundays for 1 day/week, Fridays for 3 days/week, Wednesdays for 5 days/week) to give them time to log back in.
 
+![Goal reminder email sent to a learner](images/milestones-and-engagement/04-goal-reminder-email.png)
+
 ---
 
 ## Part 4: Enabling Learner Streaks and Activity Celebrations
 
 Streak celebrations track continuous learner engagement across platform activities and display milestone pop-ups (e.g., "3 day streak").
 
+![3 day streak celebration pop-up](images/milestones-and-engagement/05-streak-celebration.png)
+
 1. **Access Django Admin:**  
    Go to your **Django Administration** panel and open **django-waffle > Flags**. Click **"Add flag +"**.
 2. **Configure the Flag:**  

docs/open-edx/course-authors/publish-a-course.md

@@ -10,9 +10,14 @@ Before publishing your course publicly, ensure you have completed the following
 
 1. **Review Course Outline:** Ensure all sections, subsections, and units are properly structured and that individual unit content has been published.
 2. **Check Course Dates:** Verify that your course start date, end date, and enrollment start/end dates are correctly configured in **Settings > Schedule & Details**.
+
+   ![Course Schedule section in Settings > Schedule & Details](images/publish-course/01-course-schedule.png)
+
 3. **Verify Grading Settings:** Confirm that your grading categories total 100% and your passing grade is set in **Settings > Grading**.
 4. **Run a Preview:** Click the **"View Live"** or **"Preview"** button in Studio to test the learner experience and ensure all links, videos, and quizzes work correctly.
 
+   ![View live button in the Studio course outline](images/publish-course/02-view-live-button.png)
+
 ## Part 2: Publishing the Course
 
 1. **Navigate to the Course Outline:**
@@ -23,6 +28,8 @@ Before publishing your course publicly, ensure you have completed the following
 
    * If you have unpublished changes or a newly created course, look for the notification banner or button at the top or side of the course outline that reads **"Publish"** or **"Release Course"**.
 
+     ![Publish option in a section's menu in the course outline](images/publish-course/03-publish-section-menu.png)
+
 3. **Confirm Publication:**
 
    * Click the **"Publish"** button.
@@ -39,4 +46,6 @@ Before publishing your course publicly, ensure you have completed the following
 
    * Log into your platform's main LMS portal (or click **"View Live"** in Studio) to confirm that the course appears in the course catalog and that the "Enroll Now" button is active and functioning properly.
 
+     ![View live button in the Studio course outline](images/publish-course/02-view-live-button.png)
+
 *Need help? If you experience any issues during registration or login, please reach out to support@abstract-technology.de.*

docs/open-edx/learners/certificates.md

@@ -16,6 +16,8 @@ Once you have successfully completed all course requirements, Open edX automatic
    * Navigate to your **Dashboard**, open your course, and click on the **"Progress"** tab. 
    * Check that all required components show completed statuses and that your final grade is posted.
 
+   ![Progress page with course completion and grades](images/certificates/01-progress-page.png)
+
 ## Part 2: Receiving Your Certificate
 
 1. **Automatic Generation:**
@@ -26,19 +28,25 @@ Once you have successfully completed all course requirements, Open edX automatic
 
    * You will typically see a notification banner on your course dashboard or receive an email notifying you that your certificate is ready.
 
+   ![Your certificate is available message with the View my certificate link](images/certificates/02-certificate-available.png)
+
 ## Part 3: Downloading Your Certificate
 
 1. **Go to Your Dashboard:**
 
    * Log in and navigate to your main **Dashboard**.
 
+   ![User menu with the Dashboard option](images/certificates/03-dashboard-menu.png)
+
 2. **Locate the Completed Course:**
 
    * Find the card for your completed course in the "Completed" section.
 
 3. **Download Options:**
 
    * Click the **"Download Certificate"** button (available as a PDF) or the **"View Certificate"** link.
+
+   ![Completed course on the dashboard with the final grade and View Certificate button](images/certificates/04-view-certificate-dashboard.png)
    * You can save the PDF to your device, print it, or share the unique certificate URL directly on professional networks like LinkedIn.
 
 *Need help? If you experience any issues during registration or login, please reach out to support@abstract-technology.de.*

docs/open-edx/learners/find-and-enroll.md

@@ -9,13 +9,21 @@ Once you are logged into your Open edX account, you can explore available course
 
 1. **Navigate to the Course Catalog / Explore Page:**
    * After logging in, click on **"Explore Courses"**, **"Discover"**, or **"Courses"** in the top navigation bar of the platform.
+
+   ![Platform home page with Explore courses in the top navigation](images/find-and-enroll/01-home-explore-courses.png)
+
 2. **Browse or Search:**
    * Use the **Search Bar** to type in keywords, topics, or course titles.
    * Use the **Filter Sidebar** (if available) to narrow down courses by subject, difficulty level, language, or instructor.
+
+   ![Explore courses page with the search bar and filters](images/find-and-enroll/02-explore-courses-search-filters.png)
+
 3. **View Course Details:**
    * Click on any course card that interests you to open its **About Page**. 
    * Here you can read the course overview, check prerequisites, see estimated weekly time commitments, and view what you will learn.
 
+   ![Course About page with the course overview](images/find-and-enroll/03-course-about-page.png)
+
 ---
 
 ## Part 2: Enrolling in a Course
@@ -24,6 +32,8 @@ Once you are logged into your Open edX account, you can explore available course
    * Depending on the platform configuration, you may see options for different enrollment tracks (e.g., Audit track for free access or Verified track for a certificate). Choose the option that fits your goals.
 2. **Click Enroll:**
    * Click the **"Enroll Now"**, **"Register"**, or **"Add to Cart"** button (prominently displayed on the course overview page).
+
+   ![Enroll now button on the course About page](images/find-and-enroll/04-enroll-now-button.png)
 3. **Confirmation & Automatic Redirect:**
    * Once enrolled, you will see a confirmation message, and the system will automatically redirect you to your **Dashboard** or directly into the course home.
 
@@ -33,7 +43,13 @@ Once you are logged into your Open edX account, you can explore available course
 
 1. **Go to Your Dashboard:**
    * Click on **"Dashboard"** in the top menu at any time to see all the courses you are currently enrolled in.
+
+   ![User menu with the Dashboard option](images/find-and-enroll/05-dashboard-menu.png)
 2. **Start Learning:**
    * Locate the course card on your dashboard and click **"View Course"** or **"Resume Course"** to open the courseware, view video lectures, complete assignments, and track your progress.
 
+   ![Course on the dashboard with the View Course button](images/find-and-enroll/06-dashboard-view-course.png)
+
+   ![Course home with the Start course button](images/find-and-enroll/07-start-course.png)
+
 *Need help? If you experience any issues during registration or login, please reach out to support@abstract-technology.de.*