Fix #630 : Oppia Terminology Wiki

wiki/Terminology-in-Oppia.md

@@ -0,0 +1,41 @@
+## 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 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.

wiki/_Sidebar.md

@@ -56,7 +56,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-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)