Added categories (#3447)

microsoft · Apr 24, 2021 · a273140 · a273140
1 parent 4b4007e
commit a273140
Show file tree

Hide file tree

Showing 6 changed files with 42 additions and 50 deletions.
diff --git a/docs/skillmap/zoo/zoo1.md b/docs/skillmap/zoo/zoo1.md
@@ -1,5 +1,3 @@
-### @flyoutOnly true
-
 # First Day
 
 
@@ -18,7 +16,7 @@ Let's get you set up in your new place!
 
 ---
 
-▶ Drag the ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` 
+▶ From the ``||sprites:Sprites||`` category, drag the ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` 
 block into the ``||loops:on start||`` container. 
 
 ▶ Click the grey box to open the **image editor** and draw yourself in your best zookeeper outfit!
@@ -50,7 +48,7 @@ let mySprite = sprites.create(img`
 
 ---
 
-▶ Drag 
+▶ From the ``||controller:Controller||`` category, drag 
 ``||controller:move [mySprite] with buttons ⊕||``  
 into the bottom of the ``||loops:on start||`` container. 
 
@@ -89,7 +87,7 @@ controller.moveSprite(mySprite)
 
 ---
 
-▶ Drag ``||scene:camera follow sprite [mySprite]||`` into the bottom 
+▶ From the ``||scene:Scene||`` category, drag ``||scene:camera follow sprite [mySprite]||`` into the bottom 
 of the ``||loops:on start||`` container and use the arrow keys to 
 check out the hut!
 
@@ -124,6 +122,7 @@ You're all ready for your first task.
 
 Click on the **Finish** button to head out to the **Zoo**!
 
+
 ```customts
 tiles.setTilemap(tilemap`level2`)
 ```

diff --git a/docs/skillmap/zoo/zoo2.md b/docs/skillmap/zoo/zoo2.md
@@ -1,5 +1,3 @@
-### @flyoutOnly true
-
 # First Exhibit: By Land
 
 
@@ -12,7 +10,7 @@ Well, what's your favorite animal? Let's invite them over!
 
 ---
 
-▶ Drag ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` 
+▶ From the ``||sprites:Sprites||`` category, drag ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` 
 into ``||loops:on start||``. 
 
 ▶ Click the grey box in the new block and draw your animal using the **image editor**!
@@ -44,7 +42,7 @@ let mySprite = sprites.create(img`
 
 ---
 
-▶ Grab
+▶From ``||sprites:Sprites||``, grab
 ``||sprites:set [mySprite] velocity to vx [50] vy [50]||`` 
 and drag it into the **end** of the ``||loops:on start||`` container. Your animal friend
 should start moving! 
@@ -81,9 +79,9 @@ The same old path gets boring after a while.
 
 ---
 
-▶ Grab two 
-``||math:pick random [0] to [10]||`` value blocks and 
-use them to replace the numbers next to the **vx** and **vy**. 
+▶ Go to the ``||math:Math||`` category and grab two 
+``||math:pick random [0] to [10]||`` value blocks. 
+Use them to replace the numbers next to the **vx** and **vy**. 
 
 ▶ Change the numbers inside the **random** blocks to see different kinds of 
 movement each time you reload!
@@ -122,8 +120,8 @@ Let's fix that.
 
 ---
 
-▶ Snap ``||sprites:set [mySprite] bounce on wall <ON>||`` 
-in at the **end** of the program.
+▶ Open the ``||sprites:Sprites||`` category, then grab ``||sprites:set [mySprite] bounce on wall <ON>||`` 
+to snap in at the **end** of the program.
 
 ---
 
@@ -178,7 +176,6 @@ You better get over there!
 
 
 
-
 ```customts
 tiles.setTilemap(tilemap`level2`)
 ```

diff --git a/docs/skillmap/zoo/zoo2a.md b/docs/skillmap/zoo/zoo2a.md
@@ -1,5 +1,3 @@
-### @flyoutOnly true
-
 # First Exhibit: By Sea
 
 ## Step 1
@@ -9,7 +7,8 @@ We're so excited to have you designing this exhibit.
 
 ---
 
-► To start, drag ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` 
+► To start, go to the ``||sprites:Sprites||`` category and drag 
+``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` 
 into the ``||loops:on start||`` container. 
 
 ► Click the grey box and use the **image editor** to 
@@ -42,7 +41,7 @@ let mySprite = sprites.create(img`
 
 ---
 
-▶ Grab
+▶ In ``||sprites:Sprites||``, find
 ``||sprites:set [mySprite] [x] to [0]||`` 
 and drag it into the **end** of the ``||loops:on start||`` container. 
 
@@ -80,7 +79,7 @@ mySprite.vx = 50
 
 ---
 
-► Snap ``||sprites:set [mySprite] bounce on wall <ON>||`` 
+► Open ``||sprites:Sprites||``, then snap ``||sprites:set [mySprite] bounce on wall <ON>||`` 
 to the end of the program and check out your exhibit in the simulator!
 
 ```blocks
@@ -147,7 +146,7 @@ mySprite.y = 0
 
 ## Step 5
 
-► Now grab a 
+► From the ``||math:Math||`` category, grab a 
 ``||math:pick random [0] to [10]||`` value block and 
 use it to replace the **0** next to ``||sprites:y||``. 
 
@@ -186,7 +185,7 @@ Let's give your sea critter a few friends!
 
 ---
 
-► Find the 
+► In ``||loops:Loops||``, find the 
 ``||loops:repeat [4] times||`` loop container and snap it into the **top** of the 
 **on start** container.
 
@@ -244,7 +243,6 @@ penguins did *what*?
 
 
 
-
 ```customts
 tiles.setTilemap(tilemap`level3`)
 effects.bubbles.startScreenEffect()

diff --git a/docs/skillmap/zoo/zoo3.md b/docs/skillmap/zoo/zoo3.md
@@ -3,9 +3,6 @@
 
 # Penguins!
 
-```customts
-tiles.setTilemap(tilemap`level1`)
-```
 
 ## Step 1 @showdialog
 
@@ -39,6 +36,10 @@ Look at this block in particular. What is it doing? Where does
 
 
 
+```customts
+tiles.setTilemap(tilemap`level1`)
+```
+
 ```template
 namespace SpriteKind {
     export const Penguin = SpriteKind.create()

diff --git a/docs/skillmap/zoo/zoo4.md b/docs/skillmap/zoo/zoo4.md
@@ -1,5 +1,3 @@
-### @flyoutOnly true
-
 # Feed the Panda
 
 ## Step 1  
@@ -21,9 +19,9 @@ It should look familiar. Can you remember what it does?
 
 ---
 
-► Drag an ``||controller:on [A] button pressed ||`` container into the workspace.
+► From ``||controller:Controller||``, drag an ``||controller:on [A] button pressed ||`` container into the workspace.
 
-► Snap ``||variables:set [mySprite] to sprite [ ] of kind [Player]||``  inside it. 
+► Snap a new ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` block inside it. 
 
 ► Make sure to change the kind to ``||sprites:Food||``, then click on 
 the grey square and draw a delicious piece of bamboo in the **image editor**.
@@ -67,13 +65,13 @@ Look at your game simulator to see what happens.
 
 ---
 
-► Grab a ``||sprites:set [mySprite] position to x [0] y [0]||``
+► From ``||sprites:Sprites||``, get a ``||sprites:set [mySprite] position to x [0] y [0]||``
 block and place it at the **end** of the ``||controller:on [A] button pressed ||`` container.
 
-► Grab two ``||math:pick random [0] to [10]||`` value blocks and 
-use them to replace the **x** and **y** values. 
+► From ``||math:Math||``, grab two ``||math:pick random [0] to [10]||`` value blocks and 
+use them to replace the **x** and **y** values in the new **set position** block. 
 
-► Try some numbers to see how they place bamboo **randomly** on the screen.
+► Try some different numbers to see how they affect the way the bamboo is **randomly** placed on the screen.
 
 
 ```blocks
@@ -112,8 +110,8 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 ---
 
-► Drag
-``||sprites:set [myEnemy] follow [mySprite]||`` into the **end**
+► Open ``||sprites:Sprites||`` and drag a
+``||sprites:set [myEnemy] follow [mySprite]||`` block out into the **end**
 of the ``||controller:on A button pressed||`` container. 
 
 ► Change the first variable value to ``||variables:panda||``, then try your code 
@@ -154,8 +152,8 @@ panda **overlaps** the bamboo.
 
 ---
 
-► Drag an ``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||`` 
-container into the workspace. 
+► From ``||sprites:Sprites||``, pull out an ``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||`` 
+container and drop it in the workspace. 
 
 ► Click on the second ``||sprites:Player||`` dropdown menu 
 and select **Food**. 
@@ -168,10 +166,10 @@ sprites.onOverlap(SpriteKind.Player, SpriteKind.Food, function (sprite, otherSpr
 
 ## Step 8
 
-► Next, grab a ``||sprites:destroy [mySprite] ⊕||`` block and put it in the 
-overlaps container. 
+► Next, grab a ``||sprites:destroy [mySprite] ⊕||`` block from ``||sprites:Sprites||``
+and put it in the **on overlaps** container. 
 
-► See the oblong value block in the header of the **overlaps** container called 
+► See the oblong value block in the header of the **on overlaps** container called 
 ``||variables:otherSprite||``? 
 Grab it and drag it down to replace **mySprite** in the **destroy** block.
 

diff --git a/docs/skillmap/zoo/zoo5.md b/docs/skillmap/zoo/zoo5.md
@@ -1,11 +1,11 @@
-### @flyoutOnly true
-
 # Quail Hatching
 
 ## Step 1   @showdialog
 
 It's quail hatching season! The quail are laying eggs left 
-and right; let's catch them and put them back into the 
+and right. 
+
+Let's catch them and put them back into the 
 quail coop. 
 
 ## step 2
@@ -27,7 +27,7 @@ At the moment, the glove doesn't do anything when it overlaps quail. We should f
 
 ---
 
-► Drag an ``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||`` 
+► From ``||sprites:Sprites||``, drag an ``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||`` 
 container into the workspace. 
 
 ► Click the **second** ``||sprites:Player||`` dropdown and 
@@ -48,11 +48,11 @@ sprites.onOverlap(SpriteKind.Player, SpriteKind.Quail, function (sprite, otherSp
 
 ---
 
-► Drag ``||sprites:set [myEnemy] follow [mySprite] ||`` into 
+► Also from ``||sprites:Sprites||``, grab ``||sprites:set [myEnemy] follow [mySprite] ||`` and drag it into 
 the empty **overlaps** container. 
 
-► Grab ``||variables:otherSprite||`` from the header of the **overlaps** container 
-and drag it down to replace the ``||variables:myEnemy||`` argument.
+► From the header of the **on overlaps** container, grab the ``||variables:otherSprite||`` value block and
+drag it down to replace the ``||variables:myEnemy||`` argument in the **set follow** block.
 
 
 
@@ -80,7 +80,7 @@ What's not happening?
 
 ---
 
-► Drag an
+► From ``||scene:Scene||``, drag an
 ``||scene:on [sprite] of kind [Player] overlaps [ ] at [location]||`` container into the workspace.
 
 ► Change **Player** to **Quail**, and change the empty tile to the **coop** tile.
@@ -161,7 +161,6 @@ Once you're done playing, click **Finish** to go back to the map where you can s
 this game with family and friends!
 
 
-
 ```template
 let mySprite = sprites.create(img`
 . . . . . 8 8 . 8 6 . 8 6 . . .