From b019aee09eb0b1c602e07e13b9d648a10377ade7 Mon Sep 17 00:00:00 2001 From: MohitGupta121 Date: Tue, 3 Oct 2023 22:18:23 +0530 Subject: [PATCH 1/4] Oppia Terminology Wiki --- wiki/Terminology in Oppia.md | 42 ++++++++++++++++++++++++++++++++++++ wiki/_Sidebar.md | 3 ++- 2 files changed, 44 insertions(+), 1 deletion(-) create mode 100644 wiki/Terminology in Oppia.md diff --git a/wiki/Terminology in Oppia.md b/wiki/Terminology in Oppia.md new file mode 100644 index 00000000000..9598d18723a --- /dev/null +++ b/wiki/Terminology in Oppia.md @@ -0,0 +1,42 @@ +## Table of Contents + +- [Overview of entities](#overview-of-entities) +- [Key terms](#key-terms) + +## Overview of entities + +This diagram outlines the various entities in Oppia and how they relate +to each other: + +```mermaid +flowchart TD +T("Topic") --> S1("Story-1") +T --> S2("Story-2") +S1 --> C1("Chapter-1/Exploration") +C1 --> c1("Card-1") +C1 --> c2("card-2") +S1 --> C2("chapter-2") +C2 --> c3("Card-3") +c3 --> co("Content") +c3 ----> in("Interaction") +in --> mc("Multiple-choice") +in --> is("Image Selection") +in --> fi("Fraction-input") +in --> oqt("other question types") +S2 --> C3("Chapter-3") +S2 --> C4("Chapter-4") +C3 --> c4("Card-4") +C4 --> c5("Card-5") +C4 --> c6("Card-6") +``` + +## Key terms + +1. **Topic**: A topic is a broad term that refers to the subject content being taught (e.g. Addition/Subtraction). It's appear on Home screen of app. +2. **Story**: Stories are situations/scenarios that are meant to help users understand the topic. For example, if the topic is addition, then one of the stories could be about where a kid goes to a shop and buys 3 pens and 4 pencils. It's appear when you click any "Topic" in "Lessons" tab. +3. **Chapter**: A chapter corresponds to different lessons through which we aim to teach the topic to the users. Each chapter has an associated exploration, and this exploration may have several cards. +4. **Promoted Story**: Promoted Story is mainly the recent Story/Chapter you played. It's shown on "home screen" with heading text "Stories For You". +5. **Skill**: This is a concrete learning outcome that describes something that a learner should be able to do. It is usually stated in the form “Given X, compute/calculate/draw/etc. Y.” For example: “Given a fraction, identify its numerator.” +6. **Exploration**: This is a structured learning experience that is part of a story, and provides the learner with an active way to learn new concepts, as well as targeted feedback. It is the core unit of learning in Oppia. The flow/screens appears when any story is started is known as Exploration. +7. **Concept Card**: This is a non-story-based explanation of how to perform a particular skill. It serves as a reference/reminder for students who may have encountered the skill before but forgotten how to carry it out. These can access from "Revision" tab or they linked within the chapter you playing. +8. **Question/QuestionPlayer**: This is a standalone question that may be used by students as part of a practice session. \ No newline at end of file diff --git a/wiki/_Sidebar.md b/wiki/_Sidebar.md index 7a43d1a78f1..27386d47a56 100644 --- a/wiki/_Sidebar.md +++ b/wiki/_Sidebar.md @@ -54,7 +54,8 @@ * Bazel * [Gradle Bazel Migration Best Practices and FAQ](https://github.com/oppia/oppia-android/wiki/Gradle--Bazel-Migration-Best-Practices-and-FAQ) * [Updating Maven Dependencies](https://github.com/oppia/oppia-android/wiki/Updating-Maven-Dependencies) - * [Internationalization](https://github.com/oppia/oppia-android/wiki/Internationalization) + * [Internationalization](https://github.com/oppia/oppia-android/wiki/Internationalization) + * [Terminology in Oppia](https://github.com/oppia/oppia/wiki/Terminology-in-Oppia) * Past Events * Google Summer of Code (note: links are to oppia/oppia): [2021](https://github.com/oppia/oppia/wiki/Google-Summer-of-Code-2021), [2020](https://github.com/oppia/oppia/wiki/Google-Summer-of-Code-2020) * [SLoP 2020](https://github.com/oppia/oppia-android/wiki/SLoP-2020) \ No newline at end of file From 7413c2c661fe92fa81bbc7cec2ac34915c09e5e3 Mon Sep 17 00:00:00 2001 From: MOHIT GUPTA <76530270+MohitGupta121@users.noreply.github.com> Date: Sat, 7 Oct 2023 19:45:39 +0530 Subject: [PATCH 2/4] Make requested changes Updated file name. --- ...nology in Oppia.md => Terminology-in-Oppia.md} | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) rename wiki/{Terminology in Oppia.md => Terminology-in-Oppia.md} (56%) diff --git a/wiki/Terminology in Oppia.md b/wiki/Terminology-in-Oppia.md similarity index 56% rename from wiki/Terminology in Oppia.md rename to wiki/Terminology-in-Oppia.md index 9598d18723a..49eff957909 100644 --- a/wiki/Terminology in Oppia.md +++ b/wiki/Terminology-in-Oppia.md @@ -32,11 +32,10 @@ C4 --> c6("Card-6") ## Key terms -1. **Topic**: A topic is a broad term that refers to the subject content being taught (e.g. Addition/Subtraction). It's appear on Home screen of app. -2. **Story**: Stories are situations/scenarios that are meant to help users understand the topic. For example, if the topic is addition, then one of the stories could be about where a kid goes to a shop and buys 3 pens and 4 pencils. It's appear when you click any "Topic" in "Lessons" tab. -3. **Chapter**: A chapter corresponds to different lessons through which we aim to teach the topic to the users. Each chapter has an associated exploration, and this exploration may have several cards. -4. **Promoted Story**: Promoted Story is mainly the recent Story/Chapter you played. It's shown on "home screen" with heading text "Stories For You". -5. **Skill**: This is a concrete learning outcome that describes something that a learner should be able to do. It is usually stated in the form “Given X, compute/calculate/draw/etc. Y.” For example: “Given a fraction, identify its numerator.” -6. **Exploration**: This is a structured learning experience that is part of a story, and provides the learner with an active way to learn new concepts, as well as targeted feedback. It is the core unit of learning in Oppia. The flow/screens appears when any story is started is known as Exploration. -7. **Concept Card**: This is a non-story-based explanation of how to perform a particular skill. It serves as a reference/reminder for students who may have encountered the skill before but forgotten how to carry it out. These can access from "Revision" tab or they linked within the chapter you playing. -8. **Question/QuestionPlayer**: This is a standalone question that may be used by students as part of a practice session. \ No newline at end of file +1. **Topic**: A topic is a broad term that refers to the subject content being taught (e.g. Addition/Subtraction). It appears on Home screen of app. +2. **Story**: Stories are situations/scenarios that are meant to help users understand the topic. For example, if the topic is addition, then one of the stories could be about where a kid goes to a shop and buys 3 pens and 4 pencils. A list of stories is shown in the "Lessons" tab when you open a topic from the home screen. +3. **Promoted Story**: Promoted Story is mainly the recent Story/Chapter you played. It is shown on the "home screen" with heading text "Stories For You". +4. **Skill**: This is a concrete learning outcome that describes something that a learner should be able to do. It is usually stated in the form “Given X, compute/calculate/draw/etc. Y.” For example: “Given a fraction, identify its numerator.” +5. **Exploration/Chapter**: This is a structured learning experience that is part of a story, and provides the learner with an active way to learn new concepts, as well as targeted feedback. It is the core unit of learning in Oppia. The flow/screens appears when any story is started is known as Exploration/Chapter. +6. **Concept Card**: This is a non-story-based explanation of how to perform a particular skill. It serves as a reference/reminder for students who may have encountered the skill before but forgotten how to carry it out. These can access from "Revision" tab or are linked within the chapter you are playing. +7. **Question/QuestionPlayer**: This is a standalone question that may be used by students as part of a practice session. \ No newline at end of file From e18daedc2b27989fc28942cd595813a98a435648 Mon Sep 17 00:00:00 2001 From: MOHIT GUPTA <76530270+MohitGupta121@users.noreply.github.com> Date: Sat, 7 Oct 2023 19:47:37 +0530 Subject: [PATCH 3/4] Updated sidebar link --- wiki/_Sidebar.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/_Sidebar.md b/wiki/_Sidebar.md index 27386d47a56..cf290d4059d 100644 --- a/wiki/_Sidebar.md +++ b/wiki/_Sidebar.md @@ -55,7 +55,7 @@ * [Gradle Bazel Migration Best Practices and FAQ](https://github.com/oppia/oppia-android/wiki/Gradle--Bazel-Migration-Best-Practices-and-FAQ) * [Updating Maven Dependencies](https://github.com/oppia/oppia-android/wiki/Updating-Maven-Dependencies) * [Internationalization](https://github.com/oppia/oppia-android/wiki/Internationalization) - * [Terminology in Oppia](https://github.com/oppia/oppia/wiki/Terminology-in-Oppia) + * [Terminology in Oppia](https://github.com/oppia/oppia-android/wiki/Terminology-in-Oppia) * Past Events * Google Summer of Code (note: links are to oppia/oppia): [2021](https://github.com/oppia/oppia/wiki/Google-Summer-of-Code-2021), [2020](https://github.com/oppia/oppia/wiki/Google-Summer-of-Code-2020) * [SLoP 2020](https://github.com/oppia/oppia-android/wiki/SLoP-2020) \ No newline at end of file From 0ba399763e4a63d6996d688374a2bf83d4cdb3e9 Mon Sep 17 00:00:00 2001 From: MOHIT GUPTA <76530270+MohitGupta121@users.noreply.github.com> Date: Mon, 9 Oct 2023 18:02:59 +0530 Subject: [PATCH 4/4] Fix grammar changes --- wiki/Terminology-in-Oppia.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/wiki/Terminology-in-Oppia.md b/wiki/Terminology-in-Oppia.md index 49eff957909..d458333dcc7 100644 --- a/wiki/Terminology-in-Oppia.md +++ b/wiki/Terminology-in-Oppia.md @@ -32,10 +32,10 @@ C4 --> c6("Card-6") ## Key terms -1. **Topic**: A topic is a broad term that refers to the subject content being taught (e.g. Addition/Subtraction). It appears on Home screen of app. -2. **Story**: Stories are situations/scenarios that are meant to help users understand the topic. For example, if the topic is addition, then one of the stories could be about where a kid goes to a shop and buys 3 pens and 4 pencils. A list of stories is shown in the "Lessons" tab when you open a topic from the home screen. +1. **Topic**: A topic is a broad term that refers to the subject content being taught (e.g. Addition/Subtraction). A list of available topics appears on the Home screen of app. +2. **Story**: Stories are situations/scenarios that are meant to help users understand the topic. For example, if the topic is addition, then one of the stories could be about a kid going to a shop and to buy 3 pens and 4 pencils. A list of stories is shown in the "Lessons" tab when you open a topic from the home screen. 3. **Promoted Story**: Promoted Story is mainly the recent Story/Chapter you played. It is shown on the "home screen" with heading text "Stories For You". 4. **Skill**: This is a concrete learning outcome that describes something that a learner should be able to do. It is usually stated in the form “Given X, compute/calculate/draw/etc. Y.” For example: “Given a fraction, identify its numerator.” -5. **Exploration/Chapter**: This is a structured learning experience that is part of a story, and provides the learner with an active way to learn new concepts, as well as targeted feedback. It is the core unit of learning in Oppia. The flow/screens appears when any story is started is known as Exploration/Chapter. -6. **Concept Card**: This is a non-story-based explanation of how to perform a particular skill. It serves as a reference/reminder for students who may have encountered the skill before but forgotten how to carry it out. These can access from "Revision" tab or are linked within the chapter you are playing. +5. **Exploration/Chapter**: This is a structured learning experience that is part of a story, and provides the learner with an active way to learn new concepts, as well as targeted feedback. It is the core unit of learning in Oppia. The flow/screen that appears when any story is started is known as the Exploration/Chapter. +6. **Concept Card**: This is a non-story-based explanation of how to perform a particular skill. It serves as a reference/reminder for students who may have encountered the skill before but forgotten how to carry it out. These can be accessed from the "Revision" tab or are linked within the chapter you are playing. 7. **Question/QuestionPlayer**: This is a standalone question that may be used by students as part of a practice session. \ No newline at end of file