An insight is a short and concise piece of knowledge containing raw learning material. These can vary in purpose and sometimes look, but generally an insight should:
express meaningful(and interesting) information
convey information into a mobile-friendly structure
not contain false information
not be purely opinionated
Multiple insights are chained up and presented to a user in the form of a Workout.
Insights are directly linked to other specific content-types:
Practice Question(PQ)
Revise Question(RQ)
This means each insight has its own PQ and RQ. The main difference between them is that the PQ is shown directly within an insight, while the RQ is shown externally(before/without) seeing the insight.
Workout
A Workout is a bundle of ~5 insights and the"unit of learning" a user is meant to complete in a single session. From a user's perspective, they completeat least one workout per day.
Workouts can be:
Normalworkouts(randomly generated) - 5 Insights of the same Level and Subtopic(a user opts-in for)
For example 5 random beginner insights on Ecmascript 2015(JavaScript) can make up such a workout
Custom Workouts - the exact insights and their order can be“hardcoded” into a custom workout
The purpose of these workouts is to provide a mean of structure and elaboration on a certain subtopic/subject of discussion.
Revision Workouts - a workout generated based on a user’s seen insights(no new content is required), in which revise questions are asked before the posibility of reviewing the insight
The purpose of this workout is to ensure the user remembers the concepts learnt in a previous workout
Practice Question
A Practice Question is a multiple-gaps exercise shown to users directly when reading the insight, at the bottom. Because it’s attached to the related insight, this question doesn’t have to be too general, but more specific with the information.
Keep in mind that this is not a must as there are certain theoretical insights that won’t fit a good practice question.
Revise Question
A Revise Question is also a multiple-gaps exercise with the exact format as the PQ.
These are shown in either Revision-Workouts or in Quick-Tests, their purpose being to test the user’s knowledge on specific insights/subject areas that he already went though.
This question will be shown first without its related insights so the information on this should be a little bit more general and easier to remember than the Practice Question.
What is an insight made out of?
A single insight is made out of multiple fields.
Some of these are mandatory(M), while other’s can sometimes be omitted.
These are:
Topic[M]
The topic usually marks the language or framework an insight is referring to/written in.
What is an insight?
Insight
Workout
Practice Question
Revise Question
What is an insight made out of?
Topic [M]