From 2e1df3d70d5c465463fdb7809d0556b9290280ab Mon Sep 17 00:00:00 2001 From: Galen Nickel Date: Wed, 3 Oct 2018 13:15:22 -0700 Subject: [PATCH] Blocks2Javascript review edits (#1341) --- docs/courses/blocks-to-javascript.md | 4 ++-- .../blocks-to-javascript/starter-blocks.md | 24 +++++++++---------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/courses/blocks-to-javascript.md b/docs/courses/blocks-to-javascript.md index e5a092f0..9c4a2a0d 100644 --- a/docs/courses/blocks-to-javascript.md +++ b/docs/courses/blocks-to-javascript.md @@ -12,14 +12,14 @@ Are you ready to try JavaScript to write your code? [ { "name": "Hello JavaScript", - "description": "Learn to convert your block code in JavaScript", + "description": "Learn how to convert your code from blocks to JavaScript", "url": "/courses/blocks-to-javascript/hello-javascript", "cardType": "side", "imageUrl": "/static/courses/blocks-to-javascript/hello-javascript.png" }, { "name": "Starter Blocks", - "description": "Start from blocks to jump into JavaScript", + "description": "Begin with blocks and then jump into JavaScript", "url": "/courses/blocks-to-javascript/starter-blocks", "cardType": "side", "imageUrl": "/static/courses/blocks-to-javascript/starter-blocks.png" diff --git a/docs/courses/blocks-to-javascript/starter-blocks.md b/docs/courses/blocks-to-javascript/starter-blocks.md index d458067a..58712e18 100644 --- a/docs/courses/blocks-to-javascript/starter-blocks.md +++ b/docs/courses/blocks-to-javascript/starter-blocks.md @@ -2,17 +2,17 @@ ## ~ hint -Use your blocks knownledge to learn JavaScript faster. +Use your knownledge of blocks to learn JavaScript faster. ## ~ -MakeCode can convert your blocks to JavaScript and back. Start from blocks and jump into JavaScript for an easier start. +MakeCode can convert your blocks to JavaScript and back. Start your program with blocks and then jump into JavaScript as an easy way to begin working in the code. ## Do it blocks then convert -So you are pretty familiar with the blocks editor and still getting used to JavaScript. MakeCode can convert any block code into JavaScript. Let's see it in action. +So you are pretty familiar with the blocks editor and still getting used to JavaScript? MakeCode can convert any block code into JavaScript. Let's see it in action. -* create a simple program in the code editor +* Create a simple program in the code editor. ```blocks input.onButtonPressed(Button.A, function () { @@ -26,7 +26,7 @@ input.onButtonPressed(Button.A, function () { }) ``` -* click on the **{} JavaScript** button in the top menu to convert the blocks to JavaScript. Voila! +* Click on the **{} JavaScript** button in the top menu to convert the blocks to JavaScript. Voila! ```typescript input.onButtonPressed(Button.A, function () { @@ -42,9 +42,9 @@ input.onButtonPressed(Button.A, function () { ## Go back to blocks -Do you feel like editing blocks again? MakeCode can convert back your JavaScript code into blocks. +Do you want to go back to editing with blocks again? MakeCode can convert your JavaScript code back into blocks. -* replace a few dots '.' with hashmarks '#' +* Replace a few dots `.` with hashmarks `#`. ```typescript input.onButtonPressed(Button.A, function () { @@ -60,11 +60,11 @@ input.onButtonPressed(Button.A, function () { ### ~ hint -So you change your JavaScript code and nothing works anymore, there are tons of red squiggle and you don't understand why... Don't panic, use the **Undo** button to revert your changes until everything works again. +Well, you changed your JavaScript code and nothing works anymore. You see gobs of red squiggles and you don't understand why... Don't panic, use the **Undo** button to revert your changes until everything works again. ### ~ -* click on the **Blocks** button in the top to convert the JavaScript back to blocks. +* Click on the **Blocks** button in the top to convert the JavaScript back to blocks. ```blocks input.onButtonPressed(Button.A, function () { @@ -80,9 +80,9 @@ input.onButtonPressed(Button.A, function () { ## Grey blocks are a good sign! -If you start to writing more complex JavaScript (good job!), MakeCode might not be able to convert it back to blocks. In that case, you will see _grey blocks_ in your block code. They represent chunks of JavaScript that are too complicated for blocks. +If you start to write more complex JavaScript (it's great that you are!), MakeCode might not be able to convert it back to blocks. In that case, you will see _grey blocks_ in your block code. They represent chunks of JavaScript that are too complicated for blocks. -* go back to **JavaScript** and add a second frame to create animation. This is something you can do in JavaScript but not in blocks. +* Go back to **JavaScript** and add a second frame to create animation. This is something you can do in JavaScript but not in blocks. ```typescript input.onButtonPressed(Button.A, function () { @@ -96,7 +96,7 @@ input.onButtonPressed(Button.A, function () { }) ``` -* go to the **Blocks** editor and you will see a big **grey** block in the button handler. This is because you are creating code too complex for the blocks. Take it as a compliment! +* Go to the **Blocks** editor and you will see a big **grey** block in the button handler. This is because you are creating code too complex for the blocks. Take it as a compliment! ```blocks input.onButtonPressed(Button.A, function () {