New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs: Fold "Glossary of Terms" and "User Documentation" into "How to Access Oppia Webpages" #415

Open

gutoslv wants to merge 2 commits into oppia:develop from gutoslv:docs-unify-glossary-and-user-doc

+18 −17

Contributor

gutoslv commented Nov 16, 2024

Issue #335

gutoslv added 2 commits

November 16, 2024 12:41


          docs: move user documentation from the sidebar to How-to-access-Oppia…

9f6e0b8

…-webpages.md

Issue oppia#335


          docs: move Glossary Of Terms to be part of the Overview of entities s…

f665e76

…ection on How-to-access-Oppia-webpages.md

Issue oppia#335
This change moves most of Glossary of Terms as a part of `other terms` under the Ovevrview of entities in order to unify and improve context on the terms.

gutoslv mentioned this pull request

Fold "Glossary of Terms" and "User Documentation" into "How to Access Oppia Webpages" #335

Open

seanlip requested changes

View reviewed changes

Member

seanlip left a comment

Thanks @gutoslv, I left some comments. I think we might want to update the glossary later on, but the edits mentioned here should do for now.

How-to-access-Oppia-webpages.md

    
            @@ -87,9 +88,21 @@ As you go through https://www.oppia.org/, you will find these entities.
          
              ### Other terms

              1. **Collection**: A group of explorations.

              2. **Community**: Anyone who teaches, learns, and contributes to any content on Oppia.

              2. - **Community** Anyone who teaches, learns, and contributes to any content on Oppia. Community members are respectful citizens whose main objective is to steward enriching learning opportunities.

Member

seanlip Nov 17, 2024

Please drop the "- " at the beginning.

Though actually I think we can drop this one. I'm not really sure that "community" needs a definition.

How-to-access-Oppia-webpages.md

 . **Opportunity**: An opportunity is specific to an exploration, and it refers to a way any contributor can contribute content to Oppia.
 . **Suggestion**: Any time any user contributes to Oppia, their contribution is added as a request which is known as a suggestion. There are two types of suggestions:
+. **Category/Subject** A category or subject that anyone can learn about on Oppia. Learners can choose from a list of categories on the home page.

Member

seanlip Nov 17, 2024

This is obsolete, let's drop it.

How-to-access-Oppia-webpages.md

 . **Opportunity**: An opportunity is specific to an exploration, and it refers to a way any contributor can contribute content to Oppia.
 . **Suggestion**: Any time any user contributes to Oppia, their contribution is added as a request which is known as a suggestion. There are two types of suggestions:
+. **Category/Subject** A category or subject that anyone can learn about on Oppia. Learners can choose from a list of categories on the home page.
+. **Contributor** Anyone who pitches in content for an exploration/lesson. One way that Oppia is more of a collaborative learning space, in contrast to more traditional online learning platforms.
+. **Create** To start an exploration/lesson in order to teach a topic

Member

seanlip Nov 17, 2024

Let's drop this one as well; "create" is self-evident. Ditto for the next point.

How-to-access-Oppia-webpages.md

+. **Create** To start an exploration/lesson in order to teach a topic
+. **Creator** A person who starts an exploration or lesson, a creator takes on the teaching role in the learning environment.
+. **Exploration** The fundamental unit of learning on Oppia. This is an interactive activity built by a creator, and consumed by a learner.
+. **Library** The page where all explorations and collection on Oppia are displayed.

Member

seanlip Nov 17, 2024

collection --> collections

How-to-access-Oppia-webpages.md

+. **Learner** A user who engages in an exploration or lesson.
+. **Response** Feedback and/or a new card that the learner is directed to based on their answer. A response can’t be empty; if a response doesn’t direct the learner to a new card, then feedback must be provided.
+. **Rule** A condition that triggers a response. Different interactions have different rule options. Multiple rules can be grouped together in a single answer group.
+. **Tags** Additional labels that can be added to an exploration in order to make it more findable in the gallery.

Member

seanlip Nov 17, 2024

gallery --> community library

seanlip assigned gutoslv

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet