diff --git a/pages/DesignTips.html b/pages/DesignTips.html index 9ea5dcc..70c33ff 100644 --- a/pages/DesignTips.html +++ b/pages/DesignTips.html @@ -9,9 +9,9 @@

One of Oppia's strengths is its ability to bring interactivity and - guided discovery learning + guide towards discovery learning - to online, computer-based learning. Thus, a common format for an Oppia exploration is to pose a problem to the reader and guide them towards + In online, computer-based learning. Thus, a common format for an Oppia exploration is to pose a problem to the reader and guide them towards solving this problem by posing a series of questions. This way, the reader actively discovers the answer with the exploration's help, as opposed to just being told what the answer is. @@ -28,7 +28,7 @@

Once you have a clear idea of what concept your exploration is trying to teach, it's usually easiest to start by coming up with a single series of questions and answers that might help a student understand this concept. - These will form the "critical path" of your exploration -- the trunk on + These will form the "critical path" of your exploration -- The trunk on which all the other branches will depend. It doesn't really matter what this path is, as long as it goes all the way from start to finish.

@@ -73,7 +73,7 @@

aria-hidden="true"> - Common misconceptions + Common Misconceptions

@@ -107,14 +107,14 @@

- Loopbacks + Loop-backs

Another way to deal with wrong answers is to simply loop back and ask the question again. But for this to be beneficial and educational, you must tell the student what was wrong with their answer. Therefore, when using - loopbacks like this, you should classify the possible wrong answers in as + loop-backs like this, you should classify the possible wrong answers in as much detail as possible, and provide detailed feedback on why a particular answer was wrong. (It might also be a good idea to mix and match: loop the student back to the question for simple mistakes, but take them on a longer @@ -124,7 +124,7 @@

There are some considerations and issues to watch out for when using - loopbacks: + loop-backs:

- A good rule of thumb for whether you should use loopbacks is whether you + A good rule of thumb for whether you should use loop-backs is whether you can separate all the possible "wrong" answers into large groups, for which you can provide explicit helpful feedback that gives the reader more information. If not, you may be better off branching into a longer @@ -229,7 +229,7 @@

Students can sometimes get confused and lost if the question is too broad or open-ended, because they are unsure of what exactly is expected of them. They may just say "I don't know". In that case, the exploration can - simply go on with a detailed guided walkthrough of the topics involved. + simply go on with a detailed guided walk-through of the topics involved. If you use a broad question like this, try to make it clear that there's no one right (or wrong) answer; you're just looking for ideas. Or, if you have a specific type of answer in mind, be as explicit as possible about @@ -325,7 +325,7 @@

Parameter-based design patterns

- Oppia's parameter functionality enables a number of interesting design + Oppia's parameter functionality enables a number of interesting design and patterns. Here is a more detailed guide to using parameters, with examples.

@@ -335,7 +335,7 @@

aria-hidden="true"> - Randomized questions + Randomized Questions

It's easy to create a randomized parameter that takes one of several @@ -348,7 +348,7 @@

aria-hidden="true"> - Making content dynamic + Making Content Dynamic

Often, when a student returns to a card they already visited, the original @@ -359,7 +359,7 @@

- {{if redux == "1" then "'So, how do you think he does it?' asks your friend." else "Ah, so where were we again?"}} + {{if redux == "1" then "'So, how do you think he does it?' asks your friends." else "Ah, so where were we again?"}} @@ -385,7 +385,7 @@

aria-hidden="true"> - Parameterized feedback + Parameterized Feedback

Sometimes it's useful to use parameters in the feedback you give to the @@ -406,7 +406,7 @@

Echoing back the answer

- Even if your exploration is not mathematical, it can be useful to echo back + Even if your exploration is not mathematical, it can be useful to Echoing_back_to the student's answer either immediately ("Oh, so you think that {{answer}}?") or later on ("I think you said that your favorite color was {{color}}?"). For the latter case, you'd diff --git a/pages/DownloadingAnExploration.html b/pages/DownloadingAnExploration.html index f9a49c6..40273d4 100644 --- a/pages/DownloadingAnExploration.html +++ b/pages/DownloadingAnExploration.html @@ -4,7 +4,7 @@

href="#Downloading_Explorations" aria-hidden="true"> - Downloading an Exploration + Downloading An Exploration

diff --git a/pages/EmbeddingAnExploration.html b/pages/EmbeddingAnExploration.html index 555548c..ac7cb5d 100644 --- a/pages/EmbeddingAnExploration.html +++ b/pages/EmbeddingAnExploration.html @@ -3,7 +3,7 @@

- Embedding an Exploration + Embedding An Exploration

@@ -26,7 +26,7 @@

- Step 1: Include the embedding script + Step 1: Include The Embedding Script

@@ -34,7 +34,7 @@