Migrate docs from the other repo

docs/reference/js/lessons/looper/challenges.md

@@ -0,0 +1,83 @@
+# looper challenges
+
+Coding challenges for the looper tutorial. #docs
+
+## Before we get started
+
+Complete the following guided tutorial:
+
+* [tutorial](/microbit/lessons/looper/tutorial)
+
+At the end of the tutorial, click `keep editing`. Your code should look like this:
+
+```
+for (let i = 0; i < 6; i++) {
+    basic.showNumber(i, 150)
+    basic.pause(2000)
+}
+```
+
+### Challenge 1
+
+### @video td/videos/looper-1
+
+What if we want to count up to lucky number 7 instead? Let's do that by changing the ending value to `8` instead of `6`.
+
+```
+for (let i1 = 0; i1 < 8; i1++) {
+    basic.showNumber(i1, 150) // ***
+    basic.pause(2000)
+}
+```
+
+* Run the program now to see your changes.
+
+### Challenge 2
+
+### @video td/videos/looper-2
+
+What about 9? Let's do that by changing the ending value to `10`.
+
+```
+for (let i2 = 0; i2 < 10; i2++) {
+    basic.showNumber(i2, 150)
+    basic.pause(2000)
+}
+```
+
+* Run your code to see the new counter.
+
+### Challenge 3
+
+### @video td/videos/looper-3
+
+Now let's start counting from `3` instead! Our for loop will always start at `0` so we simply add `3` to the `i` variable when passing it to `basic->show number`.
+
+```
+for (let i3 = 0; i3 < 8; i3++) {
+    basic.showNumber(i3 + 3, 150) // ***
+    basic.pause(2000)
+}
+```
+
+Run it on the simulator!
+
+### Challenge 4
+
+### @video td/videos/looper-4
+
+Now, let's **count down from 9**. Change the line `basic->show number(i + 3, 150)` to `basic->show number(9 - i, 150)`.
+
+```
+for (let i4 = 0; i4 < 10; i4++) {
+    basic.showNumber(9 - i4, 150) // ***
+    basic.pause(2000)
+}
+```
+
+* Run the code to make sure it is doing what is expected.
+
+### Challenge 5
+
+After counting down from `9` let's show the string `BOOOM`!
+

docs/reference/js/lessons/looper/lesson.md

@@ -0,0 +1,105 @@
+# looper lesson
+
+Learn to control blinking LEDs. #LED #screen  #for #docs
+
+### @video vimeo/134453504
+
+## Topic
+
+For loop - Blinking LED
+
+## Quick links
+
+* [tutorial](/microbit/lessons/looper/tutorial)
+* [quiz](/microbit/lessons/looper/quiz)
+* [quiz answers](/microbit/lessons/looper/quiz-answers)
+* [challenges](/microbit/lessons/looper/challenges)
+
+## Class
+
+Year 7
+
+## Prior learning/place of lesson in scheme of work
+
+Learn how to control a blinking LED. We will be learning how to create a blinking app using the for loop as well as simple commands, such as plot and pause.
+
+## What the teacher needs to know
+
+**Program:** A stored set of instructions encoded in a language understood by the computer that does some form of computation, processing input and/or stored data to generate output.**
+
+**Algorithm:** An unambiguous set of rules or a precise step-by-step guide to solve a problem or achieve a particular objective. The guided tutorial follows a algorithm and is a precise step-by-step guide to solve a problem**
+
+**Loop:** A block of code repeated automatically under the program’s control. ** The blink program introduces a While Loop. While Loop is a while loop that will repeat code forever while - true.
+
+**Command:** An instruction for the computer to execute, written in a particular programming language.**
+
+**QuickStart Computing Glossary
+
+## Documentation
+
+* **plot**: [read more...](/microbit/reference/led/plot)
+* **pause**: [read more...](/microbit/reference/basic/pause)
+* **for**: [read more...](/microbit/reference/loops/for)
+
+## Resources
+
+* Activity: [tutorial](/microbit/lessons/looper/tutorial)
+* Activity: [quiz](/microbit/lessons/looper/quiz)
+* Extended Activity: [challenges](/microbit/lessons/looper/challenges)
+
+## Objectives
+
+* learn how to blink a light
+* create a for loop that will loop through each x-value, y-value from 0 to 4.
+* learn how to pause the light on and off
+* learn how to repeat turning on and off the light
+
+## Links to the National Curriculum Programmes of Study for Computing
+
+## Progression Pathways / Computational Thinking Framework
+
+#### Algorithms
+
+* Uses logical reasoning to predict outputs, showing an awareness of inputs. (AL)
+* Understands that iteration is the repetition of a process such as a loop. (AL)
+* Represents solutions using a structured notation. (AL) (AB)
+
+#### Programming & Development
+
+* Creates programs that implement algorithms to achieve given goals. (AL)
+* Uses a variable and relational operators within a loop to govern termination. (AL) (GE)
+* Uses a range of operators and expressions e.g. Boolean, and applies them in the context of program control. (AL)
+
+#### Data & Data Representation
+
+* Understands the difference between data and information. (AB)
+* Defines data types: real numbers and Boolean. (AB)
+
+#### Information Technology
+
+*  Collects, organises and presents data and information in digital content. (AB)
+* Makes appropriate improvements to solutions based on feedback received, and can comment on the success of the solution. (EV)
+
+Computational Thinking Concept: AB = Abstraction; DE = Decomposition; AL = Algorithmic Thinking; EV = Evaluation; GE = Generalisation
+
+## Activity
+
+* time: 10 min.
+* [tutorial](/microbit/lessons/looper/tutorial)
+* [quiz](/microbit/lessons/looper/quiz)
+* assessment opportunities: loops, plot, pause, clear screen
+
+## Extended Activity
+
+* time: 20 min.
+* [challenges](/microbit/lessons/looper/challenges)
+* assessment opportunities: loops, plot, pause, clear screen
+
+## Homework
+
+* Extended Activity: [challenges](/microbit/lessons/looper/challenges)
+
+## Intended follow on
+
+Publish script to the classroom.
+

docs/reference/js/lessons/looper/quiz-answers.md

@@ -0,0 +1,40 @@
+# looper quiz answers
+
+Learn how to create a series of numbers with a for loop. #LED #screen #plot #docs
+
+This is the answer key for the [looper quiz](/microbit/lessons/looper/quiz).
+
+## 1. What is a for loop?
+
+Answers will vary. In general, for loop refers to the code that repeats for a fixed number of times. We specify the LED using x, y coordinates.
+
+## 2. Consider the following code
+
+```
+for (let i = 0; i < 4; i++) {
+    basic.showNumber(i, 150)
+}
+```
+
+If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded.
+
+Let's create a for loop where `0` is the loop's starting value, `i` is the index variable, and `4` is the ending value. The index variable `i` starts at 0 and increases by 1 each time through the loop. The loop ends when `i = 4`.
+
+![](/static/mb/lessons/looper-0.png)
+
+## 3. Consider the following code
+
+```
+for (let i1 = 0; i1 < 6; i1++) {
+    basic.showNumber(i1, 150)
+}
+```
+
+If the rectangle below represents the BBC micro:bit, shade the areas that will be displayed. Explain why that particular area is shaded.
+
+Let's create a for loop where `0` is the loop's starting value, `i` is the index variable, and `6` is the ending value. The index variable `i` starts at 0 and increases by 1 each time through the loop. The loop ends when `i = 6`.
+
+![](/static/mb/lessons/looper-0.png)
+
+![](/static/mb/lessons/looper-1.png)
+

docs/reference/js/lessons/looper/quiz.md

@@ -0,0 +1,42 @@
+# looper quiz
+
+Learn how to create a series of numbers with a for loop. #LED #screen #plot #docs
+
+## Name
+
+## Directions
+
+Use this activity document to guide your work in the [looper tutorial](/microbit/lessons/looper/tutorial)
+
+Answer the questions while completing the tutorial. Pay attention to the dialogues!
+
+## 1. Describe what a "for loop" does?
+
+<br/>
+
+## 2. Draw the areas where the LEDs will be lit based on the code below. Explain why you chose to draw those numbers.
+
+```
+for (let i = 0; i < 4; i++) {
+    basic.showNumber(i, 150)
+}
+```
+
+![](/static/mb/lessons/looper-2.png)
+
+<br/>
+
+## 3. Draw the areas where the LEDs will be lit based on the code below. Explain why you chose to draw those numbers.
+
+```
+for (let i1 = 0; i1 < 6; i1++) {
+    basic.showNumber(i1, 150)
+}
+```
+
+![](/static/mb/lessons/looper-3.png)
+
+![](/static/mb/lessons/looper-3.png)
+
+<br/>
+