Clarify bits for Rect, add setInterval and setTimeout to cloning and …

…fix first tutorial link on README.md
livewires · tjvr · Aug 2, 2019 · Aug 2, 2019 · Aug 2, 2019 · b8d768e280cfc7be1e749e70a316f787cdc9f229
commit b8d768e280cfc7be1e749e70a316f787cdc9f229
diff --git a/README.md b/README.md
@@ -3,7 +3,7 @@
 Mobile games for beginners.
 
   * [Install](https://livewires.github.io/you-win/install)
-  * Read the [Intro tutorial](https://livewires.github.io/you-win/1-numbers)
+  * Read the [Intro tutorial](https://livewires.github.io/you-win/00-new-world)
   * Make a [Doodle Jump clone](https://livewires.github.io/you-win/jump)
 
 For experts:

diff --git a/docs/cloning.html b/docs/cloning.html
@@ -28,6 +28,7 @@ <h1 class=title><a href="https://github.com/livewires/you-win">you-win</a></h1>
             <ul>
                 <li class=page-heading><a href="#functions">Functions</a>
                 <li class=page-heading><a href="#copying-a-sprite">Copying a sprite</a>
+                <li class=page-heading><a href="#delaying-the-copies">Delaying the copies</a>
                 <li class=page-heading><a href="#on-tap">On tap</a>
                 <li class=page-heading><a href="#moving-clones">Moving clones</a>
                 <li class=page-heading><a href="#destroying-clones">Destroying clones</a>
@@ -73,6 +74,15 @@ <h2 id="copying-a-sprite">Copying a sprite</h2>
 }
 </code></pre>
 <p><img class="emojione" alt="👉" title=":point_right:" src="https://cdn.jsdelivr.net/emojione/assets/3.1/png/32/1f449.png"/> Make sure there are 100 sprites created. You’ll need to randomize their positions (or something) or they’ll all be overlapping each other in the middle!</p>
+<h2 id="delaying-the-copies">Delaying the copies</h2>
+<p>Or, if we wanted to make a new copy every 3 seconds, we could use <code>setInterval</code>. This allows us to give a function that we want to execute each time and the amount of time to wait in between.</p>
+<pre><code class="lang-JS">setInterval(function() {
+    makeCow()
+}, 3000)
+</code></pre>
+<p>Note that the amount of time is in milliseconds (3000ms = 3seconds).</p>
+<p>If you wanted to only wait <em>once</em>, rather than multiple times, you can use <code>setTimeout</code> in exactly the same way.</p>
+<p>For more information on setTimeout and setInterval, including how to stop a <code>setInterval</code> from executing from running using <code>clearInterval</code>, have a look <a href="https://www.w3schools.com/js/js_timing.asp">here</a>.</p>
 <h2 id="on-tap">On tap</h2>
 <p>We can use our new function to create a sprite when you <a href="05-events#taps">tap the screen</a>. </p>
 <pre><code class="lang-js">world.onTap(e =&gt; {

diff --git a/docs/pdfs/00-new-world.pdf b/docs/pdfs/00-new-world.pdf
diff --git a/docs/pdfs/01-creating-sprites.pdf b/docs/pdfs/01-creating-sprites.pdf
diff --git a/docs/pdfs/02-position.pdf b/docs/pdfs/02-position.pdf
diff --git a/docs/pdfs/03-random.pdf b/docs/pdfs/03-random.pdf
diff --git a/docs/pdfs/04-forever.pdf b/docs/pdfs/04-forever.pdf
diff --git a/docs/pdfs/05-events.pdf b/docs/pdfs/05-events.pdf
diff --git a/docs/pdfs/06-recipes.pdf b/docs/pdfs/06-recipes.pdf
diff --git a/docs/pdfs/2-animation.pdf b/docs/pdfs/2-animation.pdf
diff --git a/docs/pdfs/3-arrays.pdf b/docs/pdfs/3-arrays.pdf
diff --git a/docs/pdfs/4-functions.pdf b/docs/pdfs/4-functions.pdf
diff --git a/docs/pdfs/angles.pdf b/docs/pdfs/angles.pdf
diff --git a/docs/pdfs/bouncing.pdf b/docs/pdfs/bouncing.pdf
diff --git a/docs/pdfs/cloning.pdf b/docs/pdfs/cloning.pdf
diff --git a/docs/pdfs/collisions.pdf b/docs/pdfs/collisions.pdf
diff --git a/docs/pdfs/install.pdf b/docs/pdfs/install.pdf
diff --git a/docs/pdfs/jump.pdf b/docs/pdfs/jump.pdf
diff --git a/docs/pdfs/reference.pdf b/docs/pdfs/reference.pdf
diff --git a/docs/pdfs/scoring.pdf b/docs/pdfs/scoring.pdf
diff --git a/docs/pdfs/scrolling.pdf b/docs/pdfs/scrolling.pdf
diff --git a/docs/reference.html b/docs/reference.html
@@ -61,6 +61,7 @@ <h2 id="importing">Importing</h2>
 <li><a href="#sprite">Sprite</a></li>
 <li><a href="#text">Text</a></li>
 <li><a href="#polygon">Polygon</a></li>
+<li><a href="#rect">Rect</a></li>
 <li><a href="#phone">Phone</a></li>
 <li><a href="#sound">Sound</a></li>
 </ul>
@@ -329,6 +330,7 @@ <h2 id="rect">Rect</h2>
 <p>See <a href="#polygon">Polygon</a> for more details.</p>
 </li>
 </ul>
+<p>Don’t forget you will need to use <code>new Rect</code> and not <code>new Polygon</code></p>
 <h2 id="touch-events">Touch Events</h2>
 <p>An <strong>event</strong> tells you that something has happened. Both Worlds and Sprites will emit events when they are tapped or dragged.</p>
 <p>If a tap overlaps more than one sprite (because the sprites are overlapping), then the sprites are told about the events in order. The front-most one sees the event first.</p>

diff --git a/docs/sheets/cloning.md b/docs/sheets/cloning.md
@@ -52,6 +52,20 @@ for (let num of uw.range(100)) {
 
 👉 Make sure there are 100 sprites created. You'll need to randomize their positions (or something) or they'll all be overlapping each other in the middle!
 
+## Delaying the copies
+
+Or, if we wanted to make a new copy every 3 seconds, we could use `setInterval`. This allows us to give a function that we want to execute each time and the amount of time to wait in between.
+```JS
+setInterval(function() {
+    makeCow()
+}, 3000)
+```
+
+Note that the amount of time is in milliseconds (3000ms = 3seconds).
+
+If you wanted to only wait *once*, rather than multiple times, you can use `setTimeout` in exactly the same way.
+
+For more information on setTimeout and setInterval, including how to stop a `setInterval` from executing from running using `clearInterval`, have a look [here](https://www.w3schools.com/js/js_timing.asp).
 
 ## On tap
 

diff --git a/docs/sheets/reference.md b/docs/sheets/reference.md
@@ -14,6 +14,7 @@ title: API Reference
 * [Sprite](#sprite)
 * [Text](#text)
 * [Polygon](#polygon)
+* [Rect](#rect)
 * [Phone](#phone)
 * [Sound](#sound)
 
@@ -410,6 +411,7 @@ Instead of a `costume`, `Rect`s have the following:
 
     See [Polygon](#polygon) for more details.
 
+Don't forget you will need to use `new Rect` and not `new Polygon`
 
 ## Touch Events