Lessons

Lessons are the individual sections of a module. Each lesson is contained in its own folder, which is numbered and named after the lesson.

Lessons should be focused on a single topic or concept, and should be structured to help the learner understand and apply the material. Shorter lessons are better than longer ones.

Structure

Lesson files are named lesson.adoc and contain the content for the lesson.

The lesson.adoc file must contain:

  • A :type:

  • An :order:

  • A title (= Heading) for the lesson

  • A read:: or a question to complete the lesson

  • A [.summary] section to display when the lesson is completed

lesson.adoc
= Lesson Title
:type: lesson
:order: 1

Lesson content goes here.

== End of the lesson

read::Message to complete the course[]

[.summary]
== Summary

Congratulations on completing the lesson.

Types

Lessons can have one of the following types:

  • lesson - a standard lesson

  • challenge - a lessons that is a challenge or exercise

  • video - a video lesson

  • quiz - a quiz lesson

The type should describe the overall content of the lesson. For example, if the lesson is primarily a video, it should be marked as video. If a lesson is a list of questions, it should be marked as quiz. If a lesson is a standard lesson, but it contains a single question, it should be marked as lesson.

Video

Not every lesson needs a video.

Video should be used in lessons when it is helpful to explain a concept, to demonstrate a complicated process, or build learners confidence. Video lessons should be short, ideally under 5 minutes, and should be used to supplement the course content.

A written version (transcript) of the video should be provided in the lesson content.

= Lesson Title
:type: video
:order: 1

In this lesson, you will ...

[.video]
== Video Lesson

video::a0L5iQiIO80[youtube,width=560,height=315]

[.transcript]
== Written Lesson

The written version of the video should contain the same content as the video, but in a written format.

== Other lesson content

This content will be shown at the end of the lesson.

read::Complete[]

[.summary]
== Summary

You have completed the video lesson.

Summary

In this lesson, you learned about the structure of a lesson in GraphAcademy

In the next lesson, you will learn about GraphAcademy questions.

Chatbot

How can I help you today?