diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd595245455d0dca3434ba.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd595245455d0dca3434ba.md index 2bea1b52447..23aee4ab0e1 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd595245455d0dca3434ba.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd595245455d0dca3434ba.md @@ -7,8 +7,145 @@ dashedName: dialogue-1-navigating-documentation # --description-- -Watch the video above to understand the context of the upcoming lessons. +Watch the video to understand the context of the upcoming lessons. # --assignment-- Watch the video + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 } + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1 + }, + "alwaysShowDialogue": true + }, + "commands": [ + { + "character": "Tom", + "position": { "x": 25, "y": 0, "z": 1 }, + "startTime": 0 + }, + { + "character": "Sarah", + "position": { "x": 70, "y": 0, "z": 1 }, + "startTime": 0.5 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 5.68, + "dialogue": { + "text": "I'm trying to understand the code documentation but it's quite overwhelming.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 5.16, + "finishTime": 7.28, + "dialogue": { + "text": "What should I do to navigate it more effectively?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 8, + "finishTime": 10.74, + "dialogue": { + "text": "Don't worry. When you're faced with extensive documentation,", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 11.14, + "finishTime": 14.66, + "dialogue": { + "text": "the first thing you should do is check for a table of contents or an index.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 14.98, + "finishTime": 17.94, + "dialogue": { + "text": "It can help you find the specific information you're looking for.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 18.28, + "finishTime": 21.3, + "dialogue": { + "text": "Okay, that makes sense. And what should I do next?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 21.88, + "finishTime": 25.98, + "dialogue": { + "text": "Once you've found the section you need, you should start by reading the introductory paragraphs", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 25.98, + "finishTime": 28.62, + "dialogue": { + "text": "to get an overview of what the documentation covers.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 29.22, + "finishTime": 32.88, + "dialogue": { + "text": "Then you can skim through and focus on the parts relevant to your current task.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 33.42, + "finishTime": 36.16, + "dialogue": { + "text": "Thanks, I'll go over the documentation as you said.", + "align": "left" + } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 }, + "startTime": 36.56 + }, + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 }, + "startTime": 37.16 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5a9680a9540e9787dec5.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5a9680a9540e9787dec5.md index c32d26f1f32..4b8876ba54e 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5a9680a9540e9787dec5.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5a9680a9540e9787dec5.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-1 --- - + # --description-- @@ -41,3 +38,60 @@ This word describes a situation where something feels too difficult or too much ### --feedback-- This word means in a way that is successful and achieves what you want. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 0, + "finishTimestamp": 6.28 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 4.68, + "dialogue": { + "text": "I'm trying to understand the code documentation but it's quite overwhelming.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 5.16, + "finishTime": 7.28, + "dialogue": { + "text": "What should I do to navigate it more effectively?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 7.78 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5c89285ea50f25bd0241.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5c89285ea50f25bd0241.md index 486c8618fbc..0c3530e6fde 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5c89285ea50f25bd0241.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5c89285ea50f25bd0241.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-2 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ While Tom is seeking help, he specifically asks for ways to navigate the documen ## --video-solution-- 1 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 0, + "finishTimestamp": 6.28 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 4.68, + "dialogue": { + "text": "I'm trying to understand the code documentation but it's quite overwhelming.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 5.16, + "finishTime": 7.28, + "dialogue": { + "text": "What should I do to navigate it more effectively?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 7.78 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5d1a6cb7f10f77a06163.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5d1a6cb7f10f77a06163.md index 4c2e10416ef..09aafaa0df4 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5d1a6cb7f10f77a06163.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5d1a6cb7f10f77a06163.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-3 --- - + # --description-- @@ -44,4 +41,61 @@ It means encountering or dealing with something, often a problem or challenge. ### --feedback-- -This word in this context is part of `table of contents`, which helps navigate a document by listing its main parts. +This word in this context is part of a phrase which helps navigate a document by listing its main parts. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 6.8, + "finishTimestamp": 13.86 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 4.14, + "dialogue": { + "text": "Don't worry. When you're faced with extensive documentation,", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 4.44, + "finishTime": 8.06, + "dialogue": { + "text": "the first thing you should do is check for a table of contents or an index.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 8.56 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5da902959d0fda781aa3.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5da902959d0fda781aa3.md index e81409d215c..b5d6f8d7a96 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5da902959d0fda781aa3.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5da902959d0fda781aa3.md @@ -5,17 +5,21 @@ challengeType: 22 dashedName: task-4 --- + + # --description-- `Extensive` means large in amount or scope. For example, `The researcher conducted an extensive study.` It conveys something vast or wide-ranging. An `index` is a list, usually at the end of a book or document, that tells you where to find specific information. Like, `I used the index to find the topic I was interested in.` +Fill in the blanks below. + # --fillInTheBlank-- ## --sentence-- -`When you're faced with _ documentation, the first thing you should do is _ for a table of contents or an _.` +`Don't worry. When you're faced with _ documentation, the first thing you should do is _ for a table of contents or an _.` ## --blanks-- @@ -40,3 +44,60 @@ It means to look at something to confirm its presence or accuracy. Sarah suggest ### --feedback-- It's a list in a document or book used for finding specific information. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 6.8, + "finishTimestamp": 13.86 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 4.14, + "dialogue": { + "text": "Don't worry. When you're faced with extensive documentation,", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 4.44, + "finishTime": 8.06, + "dialogue": { + "text": "the first thing you should do is check for a table of contents or an index.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 8.56 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5dfc174596101eae1107.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5dfc174596101eae1107.md index bcecb38133c..462b5de7e7e 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5dfc174596101eae1107.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5dfc174596101eae1107.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-5 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ Check for a table of contents or an index ## --video-solution-- 4 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 6.8, + "finishTimestamp": 13.86 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 4.14, + "dialogue": { + "text": "Don't worry. When you're faced with extensive documentation,", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 4.44, + "finishTime": 8.06, + "dialogue": { + "text": "the first thing you should do is check for a table of contents or an index.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 8.56 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f2abfdbc510942d76f8.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f2abfdbc510942d76f8.md index a2933bc8d8e..136cb7b789a 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f2abfdbc510942d76f8.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f2abfdbc510942d76f8.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-6 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,69 @@ The focus of Sarah's advice is on efficient navigation, not on evaluating the do ## --video-solution-- 2 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 6.8, + "finishTimestamp": 16.94 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 3.94, + "dialogue": { + "text": "Don't worry. When you're faced with extensive documentation,", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 4.34, + "finishTime": 8.06, + "dialogue": { + "text": "the first thing you should do is check for a table of contents or an index.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 8.18, + "finishTime": 11.14, + "dialogue": { + "text": "It can help you find the specific information you're looking for.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 11.64 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f86457b4910e35b51c9.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f86457b4910e35b51c9.md index af9144dbc90..0fe54c4fef6 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f86457b4910e35b51c9.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f86457b4910e35b51c9.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-7 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --fillInTheBlank-- @@ -26,7 +23,7 @@ Answer the question below. ### --feedback-- -In this context, it's part of expressing that something is understandable or logical. +In this context, it's part of a phrase expressing that something is understandable or logical. --- @@ -35,3 +32,51 @@ In this context, it's part of expressing that something is understandable or log ### --feedback-- It's about what should be done following the current action or step. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 17.28, + "finishTimestamp": 20.3 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 4.02, + "dialogue": { + "text": "Okay, that makes sense. And what should I do next?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 4.52 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa914bc44081a196fa6f7.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa914bc44081a196fa6f7.md index 7cae6eda07f..bc085562694 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa914bc44081a196fa6f7.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa914bc44081a196fa6f7.md @@ -15,7 +15,7 @@ dashedName: task-10 ## --text-- -Why would someone skim through a technical document? +Why would someone `skim through` a technical document? ## --answers-- diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa9d80e7ffb1ab9b4df1c.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa9d80e7ffb1ab9b4df1c.md index eceebb3661c..33b0c1e2481 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa9d80e7ffb1ab9b4df1c.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa9d80e7ffb1ab9b4df1c.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-11 --- - + # --description-- -Fill in the blanks in the dialogue below. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -51,3 +48,51 @@ This word refers to the beginning paragraphs that provide a basic understanding ### --feedback-- It means what the documentation includes or addresses in terms of content. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 20.68, + "finishTimestamp": 27.82 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 8.14, + "dialogue": { + "text": "Once you've found the section you need, you should start by reading the introductory paragraphs to get an overview of what the documentation covers.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 8.64 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff2b49779301d9bdab6fa.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff2b49779301d9bdab6fa.md index d5275b3d89d..8db56140b60 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff2b49779301d9bdab6fa.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff2b49779301d9bdab6fa.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-12 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,51 @@ While asking for help can be useful, Sarah specifically advises reading the intr ## --video-solution-- 3 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 20.68, + "finishTimestamp": 27.82 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 8.14, + "dialogue": { + "text": "Once you've found the section you need, you should start by reading the introductory paragraphs to get an overview of what the documentation covers.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 8.64 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff336d7553c1df86f7968.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff336d7553c1df86f7968.md index 5f5e18c7f15..d716868e12c 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff336d7553c1df86f7968.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff336d7553c1df86f7968.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-13 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -52,3 +49,50 @@ Sarah recommends skimming through the document and focusing on relevant parts, n 2 +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 28.02, + "finishTimestamp": 32.08 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 5.06, + "dialogue": { + "text": "Then you can skim through and focus on the parts relevant to your current task.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 5.56 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff428290eaa1e5819c119.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff428290eaa1e5819c119.md index 9a01ef72df8..0525b579b48 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff428290eaa1e5819c119.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff428290eaa1e5819c119.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-14 --- - + # --description-- @@ -37,3 +34,51 @@ This word is part of a phrasal verb that means to review, examine, or study some ### --feedback-- It refers to something that was previously mentioned or advised by someone. Tom is acknowledging Sarah's suggested approach. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1, + "startTimestamp": 32.22, + "finishTimestamp": 35.16 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 3.94, + "dialogue": { + "text": "Thanks, I'll go over the documentation as you said.", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 4.44 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff57ce568cf1ed9702fbf.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff57ce568cf1ed9702fbf.md index 2997605b615..48625183607 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff57ce568cf1ed9702fbf.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff57ce568cf1ed9702fbf.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-15 --- - + # --description-- -This is a review of the dialogue. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -82,7 +79,7 @@ It means directly relating to the topic or problem at hand. Tom should focus on ### --feedback-- -`Go over` means to review or examine something carefully. Tom agrees to follow Sarah's advice. +It's a part of a phrase meaning to review or examine something carefully. Tom agrees to follow Sarah's advice. --- @@ -91,3 +88,140 @@ It means directly relating to the topic or problem at hand. Tom should focus on ### --feedback-- It's part of a phrase used by Tom to acknowledge that he will follow the advice Sarah gave him. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 } + } + ], + "audio": { + "filename": "7.2-1.mp3", + "startTime": 1 + }, + "alwaysShowDialogue": true + }, + "commands": [ + { + "character": "Tom", + "position": { "x": 25, "y": 0, "z": 1 }, + "startTime": 0 + }, + { + "character": "Sarah", + "position": { "x": 70, "y": 0, "z": 1 }, + "startTime": 0.5 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 5.68, + "dialogue": { + "text": "I'm trying to understand the code documentation but it's quite overwhelming.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 5.16, + "finishTime": 7.28, + "dialogue": { + "text": "What should I do to navigate it more effectively?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 8, + "finishTime": 10.74, + "dialogue": { + "text": "Don't worry. When you're faced with extensive documentation,", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 11.14, + "finishTime": 14.66, + "dialogue": { + "text": "the first thing you should do is check for a table of contents or an index.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 14.98, + "finishTime": 17.94, + "dialogue": { + "text": "It can help you find the specific information you're looking for.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 18.28, + "finishTime": 21.3, + "dialogue": { + "text": "Okay, that makes sense. And what should I do next?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 21.88, + "finishTime": 25.98, + "dialogue": { + "text": "Once you've found the section you need, you should start by reading the introductory paragraphs", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 25.98, + "finishTime": 28.62, + "dialogue": { + "text": "to get an overview of what the documentation covers.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 29.22, + "finishTime": 32.88, + "dialogue": { + "text": "Then you can skim through and focus on the parts relevant to your current task.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 33.42, + "finishTime": 36.16, + "dialogue": { + "text": "Thanks, I'll go over the documentation as you said.", + "align": "left" + } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 }, + "startTime": 36.56 + }, + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 }, + "startTime": 37.16 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000a440c2f492ddee509f9.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000a440c2f492ddee509f9.md index 59691e6fd90..36ccc5f4cde 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000a440c2f492ddee509f9.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000a440c2f492ddee509f9.md @@ -7,8 +7,136 @@ dashedName: dialogue-2-understanding-function-descriptions # --description-- -Watch the video below to understand the context of the upcoming lessons. +Watch the video to understand the context of the upcoming lessons. # --assignment-- Watch the video + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 } + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1 + }, + "alwaysShowDialogue": true + }, + "commands": [ + { + "character": "Tom", + "position": { "x": 25, "y": 0, "z": 1 }, + "startTime": 0 + }, + { + "character": "Sarah", + "position": { "x": 70, "y": 0, "z": 1 }, + "startTime": 0.5 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 6.38, + "dialogue": { + "text": "I often find function descriptions in the documentation, but I'm not sure how to interpret them.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 6.62, + "finishTime": 8.62, + "dialogue": { + "text": "What should I focus on when I'm reading these?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 9.3, + "finishTime": 13.86, + "dialogue": { + "text": "That's a great question. First, you should pay attention to the function's name and parameters.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 14.2, + "finishTime": 17.68, + "dialogue": { + "text": "It can give you an idea of what the function does and how to use it.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 17.82, + "finishTime": 20.28, + "dialogue": { + "text": "Got it. Is there anything else I should keep in mind?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 21.1, + "finishTime": 25.68, + "dialogue": { + "text": "Absolutely. You should look for a description of what the function does and any return values.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 26.28, + "finishTime": 29.02, + "dialogue": { + "text": "Also, check for any examples or code snippets.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 29.02, + "finishTime": 32.16, + "dialogue": { + "text": "They can help you illustrate how to use the function effectively.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 32.9, + "finishTime": 34.22, + "dialogue": { + "text": "Great tips. Thanks a lot.", + "align": "left" + } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 }, + "startTime": 34.72 + }, + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 }, + "startTime": 35.22 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000ac46e87f52e84328b95.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000ac46e87f52e84328b95.md index f305fc0bf77..1b66c14ade0 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000ac46e87f52e84328b95.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000ac46e87f52e84328b95.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-16 --- - + # --description-- @@ -20,7 +17,7 @@ Tom: I often find function descriptions in the documentation, but I'm not sure h ## --sentence-- -`I _ find function descriptions in the documentation, but I'm not sure how to _ them. What should I _ on when reading these?` +`I _ find function descriptions in the documentation, but I'm not sure how to _ them. What should I _ on when I'm reading these?` ## --blanks-- @@ -45,3 +42,60 @@ It means to understand or explain the meaning. Tom is unsure how to understand t ### --feedback-- It means to concentrate or give special attention to something. Tom is asking what aspects to concentrate on in the function descriptions. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 0, + "finishTimestamp": 7.62 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 6.38, + "dialogue": { + "text": "I often find function descriptions in the documentation, but I'm not sure how to interpret them.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 6.62, + "finishTime": 8.62, + "dialogue": { + "text": "What should I focus on when I'm reading these?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 9.12 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000eeeec06b6338a5c5caf.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000eeeec06b6338a5c5caf.md index ef9fa571946..756805c23f6 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000eeeec06b6338a5c5caf.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000eeeec06b6338a5c5caf.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-17 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ How frequently does Tom find function descriptions in the documentation? ## --video-solution-- 3 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 0, + "finishTimestamp": 7.62 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 6.38, + "dialogue": { + "text": "I often find function descriptions in the documentation, but I'm not sure how to interpret them.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 6.62, + "finishTime": 8.62, + "dialogue": { + "text": "What should I focus on when I'm reading these?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 9.12 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000f74c71b623407a8394e.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000f74c71b623407a8394e.md index 3215ecd8516..de4a6257c3d 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000f74c71b623407a8394e.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000f74c71b623407a8394e.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-18 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ Tom's concern is about understanding the existing descriptions, not about rewrit ## --video-solution-- 3 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 0, + "finishTimestamp": 7.62 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 6.38, + "dialogue": { + "text": "I often find function descriptions in the documentation, but I'm not sure how to interpret them.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 6.62, + "finishTime": 8.62, + "dialogue": { + "text": "What should I focus on when I'm reading these?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 9.12 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000fec4b5a8c348421fada.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000fec4b5a8c348421fada.md index cf4969f80b2..44bdc0ac08d 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000fec4b5a8c348421fada.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000fec4b5a8c348421fada.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-19 --- - + # --description-- @@ -20,7 +17,7 @@ In programming, `parameters` are the special kind of variables in a function tha ## --sentence-- -`First, you should _ attention to the function's name and _.` +`That's a great question. First, you should _ attention to the function's name and _.` ## --blanks-- @@ -28,7 +25,7 @@ In programming, `parameters` are the special kind of variables in a function tha ### --feedback-- -`Pay attention` means to focus or concentrate on something. Sarah advises focusing on specific aspects of the function. +It's a part of a phrase meaning to focus or concentrate on something. Sarah advises focusing on specific aspects of the function. --- @@ -37,3 +34,60 @@ In programming, `parameters` are the special kind of variables in a function tha ### --feedback-- They are values that functions use to pass data or information into the function. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 8.2, + "finishTimestamp": 12.96 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 2.18, + "dialogue": { + "text": "That's a great question.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 2.74, + "finishTime": 5.76, + "dialogue": { + "text": "First, you should pay attention to the function's name and parameters.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 6.26 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600107b9dffa8350e0c4ee8.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600107b9dffa8350e0c4ee8.md index b546e71ba88..25dc3da048e 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600107b9dffa8350e0c4ee8.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600107b9dffa8350e0c4ee8.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-20 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,69 @@ Sarah's suggestion is aimed at understanding the function's role and usage, not ## --video-solution-- 3 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 8.2, + "finishTimestamp": 16.68 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 2.08, + "dialogue": { + "text": "That's a great question.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 2.64, + "finishTime": 5.66, + "dialogue": { + "text": "First, you should pay attention to the function's name and parameters.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 6, + "finishTime": 9.48, + "dialogue": { + "text": "It can give you an idea of what the function does and how to use it.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 9.98 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011289b5237359f69c76b.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011289b5237359f69c76b.md index 434b06bb3a1..446ab77749e 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011289b5237359f69c76b.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011289b5237359f69c76b.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-21 --- - + # --description-- -This task is about understanding Tom's question. He is asking if there is more information or advice he needs to know about understanding function descriptions in documentation. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,51 @@ Tom is asking if there's more advice or tips he should know about. ## --video-solution-- 4 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 16.62, + "finishTimestamp": 19.28 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 3.66, + "dialogue": { + "text": "Got it. Is there anything else I should keep in mind?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 4.16 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011d015f7d43626524ef8.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011d015f7d43626524ef8.md index fc6a7a10d70..9dc1ae05c8f 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011d015f7d43626524ef8.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011d015f7d43626524ef8.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-22 --- - + # --description-- @@ -37,3 +34,51 @@ It refers to the detailed explanation of the function's purpose and operations. ### --feedback-- It's a specific set of instructions in programming that performs a particular task. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 19.9, + "finishTimestamp": 24.88 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 5.98, + "dialogue": { + "text": "Absolutely. You should look for a description of what the function does and any return values.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 6.48 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012a18576e836ea18fa0b.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012a18576e836ea18fa0b.md index 0af01723a4a..e550a39506b 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012a18576e836ea18fa0b.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012a18576e836ea18fa0b.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-23 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,51 @@ Sarah mentions understanding the function's purpose and return values, not the e ## --video-solution-- 3 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 19.9, + "finishTimestamp": 24.88 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 5.98, + "dialogue": { + "text": "Absolutely. You should look for a description of what the function does and any return values.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 6.48 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012ff748bf2375c31b591.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012ff748bf2375c31b591.md index 479a69bb139..e1bd9b94444 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012ff748bf2375c31b591.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012ff748bf2375c31b591.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-24 --- - + # --description-- @@ -35,3 +32,60 @@ It refers to small pieces of code that can be used as examples to understand lar ### --feedback-- It means in a way that is successful in producing the desired result. Here, it's about using the function in the best possible way. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 25.08, + "finishTimestamp": 31.16 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 3.94, + "dialogue": { + "text": "Also, check for any examples or code snippets.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 3.94, + "finishTime": 7.08, + "dialogue": { + "text": "They can help you illustrate how to use the function effectively.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 7.58 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660013ce54713f37ecac079d.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660013ce54713f37ecac079d.md index 87665c2a427..065826fccaf 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660013ce54713f37ecac079d.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660013ce54713f37ecac079d.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-25 --- - + # --description-- -This task assesses your understanding of why Sarah suggests Tom should check for examples and code snippets when reading function descriptions. Identifying the rationale behind specific advice is crucial for effective learning and application in technical fields. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ The purpose of checking examples and snippets is to learn how to use the functio ## --video-solution-- 1 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 25.08, + "finishTimestamp": 31.16 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 3.94, + "dialogue": { + "text": "Also, check for any examples or code snippets.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 3.94, + "finishTime": 7.08, + "dialogue": { + "text": "They can help you illustrate how to use the function effectively.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 7.58 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600144958b1d33857b0309f.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600144958b1d33857b0309f.md index 583f7077fbf..d6d952a6d42 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600144958b1d33857b0309f.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600144958b1d33857b0309f.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-26 --- - + # --description-- @@ -29,3 +26,51 @@ For example, `She gave me some helpful tips on how to improve my coding skills.` ### --feedback-- It refers to the useful pieces of advice or suggestions that Sarah gave Tom to understand function descriptions better. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1, + "startTimestamp": 31.5, + "finishTimestamp": 33.22 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 2.72, + "dialogue": { + "text": "Great tips. Thanks a lot.", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 3.22 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660014d3f5b02038de6ac35c.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660014d3f5b02038de6ac35c.md index 11f899bb728..abf0233e2da 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660014d3f5b02038de6ac35c.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660014d3f5b02038de6ac35c.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-27 --- - + # --description-- -This task involves summarizing the conversation between Tom and Sarah about understanding function descriptions in documentation. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -42,7 +39,7 @@ This word means to understand or explain the meaning. Tom is looking for advice ### --feedback-- -They are part of a function's definition, giving clues about what the function does. +They are parts of a function's definition, giving clues about what the function does. --- @@ -58,7 +55,7 @@ It gives details about what the function is designed to do. ### --feedback-- -`Return values` are what the function gives back after processing. +It indicates what the function gives back after processing. --- @@ -83,3 +80,131 @@ They are small pieces of code that provide practical examples of usage. ### --feedback-- It means useful pieces of advice that Sarah gives to Tom. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 } + } + ], + "audio": { + "filename": "7.2-2.mp3", + "startTime": 1 + }, + "alwaysShowDialogue": true + }, + "commands": [ + { + "character": "Tom", + "position": { "x": 25, "y": 0, "z": 1 }, + "startTime": 0 + }, + { + "character": "Sarah", + "position": { "x": 70, "y": 0, "z": 1 }, + "startTime": 0.5 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 6.38, + "dialogue": { + "text": "I often find function descriptions in the documentation, but I'm not sure how to interpret them.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 6.62, + "finishTime": 8.62, + "dialogue": { + "text": "What should I focus on when I'm reading these?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 9.3, + "finishTime": 13.86, + "dialogue": { + "text": "That's a great question. First, you should pay attention to the function's name and parameters.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 14.2, + "finishTime": 17.68, + "dialogue": { + "text": "It can give you an idea of what the function does and how to use it.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 17.82, + "finishTime": 20.28, + "dialogue": { + "text": "Got it. Is there anything else I should keep in mind?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 21.1, + "finishTime": 25.68, + "dialogue": { + "text": "Absolutely. You should look for a description of what the function does and any return values.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 26.28, + "finishTime": 29.02, + "dialogue": { + "text": "Also, check for any examples or code snippets.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 29.02, + "finishTime": 32.16, + "dialogue": { + "text": "They can help you illustrate how to use the function effectively.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 32.9, + "finishTime": 34.22, + "dialogue": { + "text": "Great tips. Thanks a lot.", + "align": "left" + } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 }, + "startTime": 34.72 + }, + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 }, + "startTime": 35.22 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660019617debd03c767e0a3d.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660019617debd03c767e0a3d.md index 0f4a3ec30ad..a0893e10761 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660019617debd03c767e0a3d.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660019617debd03c767e0a3d.md @@ -7,8 +7,136 @@ dashedName: dialogue-3-understanding-parameters-and-options # --description-- -Watch the video below to understand the context of the upcoming lessons. +Watch the video to understand the context of the upcoming lessons. # --assignment-- Watch the video + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 } + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1 + }, + "alwaysShowDialogue": true + }, + "commands": [ + { + "character": "Tom", + "position": { "x": 25, "y": 0, "z": 1 }, + "startTime": 0 + }, + { + "character": "Sarah", + "position": { "x": 70, "y": 0, "z": 1 }, + "startTime": 0.5 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 5.72, + "dialogue": { + "text": "I sometimes get confused with the parameters and options listed in the documentation.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 6.04, + "finishTime": 7.76, + "dialogue": { + "text": "What should I do to understand them better?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 8.52, + "finishTime": 10.5, + "dialogue": { + "text": "You should begin by reading their descriptions.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 10.74, + "finishTime": 14.84, + "dialogue": { + "text": "The documentation can provide details on what each parameter does and how to use it.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 15.2, + "finishTime": 17.58, + "dialogue": { + "text": "I'll keep that in mind. What should I do next?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 18.18, + "finishTime": 22.64, + "dialogue": { + "text": "Next, you should look for any examples that demonstrate how to use these parameters in practice.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 23.22, + "finishTime": 27.04, + "dialogue": { + "text": "Examples can show you how to set options correctly and what effect they have on the code.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 27.46, + "finishTime": 30.84, + "dialogue": { + "text": "Thank you. Your guidance is helping me navigate the documentation better.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 31.12, + "finishTime": 32.32, + "dialogue": { + "text": "I'll follow your recommendations.", + "align": "left" + } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 }, + "startTime": 32.82 + }, + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 }, + "startTime": 33.32 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001985c091f13cda6d4f4d.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001985c091f13cda6d4f4d.md index 7fb668f7081..e2722e3bbd6 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001985c091f13cda6d4f4d.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001985c091f13cda6d4f4d.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-28 --- - + # --description-- -Fill in the blanks in the dialogue below. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -51,3 +48,60 @@ It refers to items being written down or included in a list, like the parameters ### --feedback-- In this context, it means to understand more clearly or effectively. Tom wants to improve his understanding of the documentation. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-breakroom.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 0, + "finishTimestamp": 6.76 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 5.72, + "dialogue": { + "text": "I sometimes get confused with the parameters and options listed in the documentation.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 6.04, + "finishTime": 7.76, + "dialogue": { + "text": "What should I do to understand them better?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 8.26 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a1c9df0a83d8e8c670a.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a1c9df0a83d8e8c670a.md index 7b3457e239b..edcc6593528 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a1c9df0a83d8e8c670a.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a1c9df0a83d8e8c670a.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-29 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ Tom specifically mentions his confusion about parameters and options, not the en ## --video-solution-- 2 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 0, + "finishTimestamp": 6.76 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 5.72, + "dialogue": { + "text": "I sometimes get confused with the parameters and options listed in the documentation.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 6.04, + "finishTime": 7.76, + "dialogue": { + "text": "What should I do to understand them better?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 8.26 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a935988e43e1183bd38.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a935988e43e1183bd38.md index 30bc71edccd..76aa3547a35 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a935988e43e1183bd38.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a935988e43e1183bd38.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-30 --- - + # --description-- -Fill in the blanks in the dialogue below. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -43,3 +40,60 @@ It means to offer information or details. The documentation gives information ab ### --feedback-- It refers to every one of the parameters, considered one by one. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 7.32, + "finishTimestamp": 13.84 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 3.18, + "dialogue": { + "text": "You should begin by reading their descriptions.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 3.42, + "finishTime": 7.52, + "dialogue": { + "text": "The documentation can provide details on what each parameter does and how to use it.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 8.02 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b1aa59adc3ea4b024b4.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b1aa59adc3ea4b024b4.md index 67591a4aac6..4c7e65b8a04 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b1aa59adc3ea4b024b4.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b1aa59adc3ea4b024b4.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-31 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ By providing details on what each parameter does and how to use it ## --video-solution-- 4 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 7.32, + "finishTimestamp": 13.84 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 3.18, + "dialogue": { + "text": "You should begin by reading their descriptions.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 3.42, + "finishTime": 7.52, + "dialogue": { + "text": "The documentation can provide details on what each parameter does and how to use it.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 8.02 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b8d0518d03f18b19715.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b8d0518d03f18b19715.md index db611565f3c..ea70848351c 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b8d0518d03f18b19715.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b8d0518d03f18b19715.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-32 --- - + # --description-- -Fill in the blanks in the dialogue below. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -35,3 +32,60 @@ It means to continue to remember or consider the advice given. ### --feedback-- It's about what Tom should do after considering the current advice. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 14.2, + "finishTimestamp": 16.58 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 2.02, + "dialogue": { + "text": "I'll keep that in mind.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 2.32, + "finishTime": 3.38, + "dialogue": { + "text": "What should I do next?", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 3.88 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001be61f20a33f8a45f3cb.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001be61f20a33f8a45f3cb.md index 2671282b945..9e6a47da14e 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001be61f20a33f8a45f3cb.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001be61f20a33f8a45f3cb.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-33 --- - + # --description-- -Fill in the blanks in the dialogue below. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -51,3 +48,60 @@ In this context, It's about adjusting or configuring options in a certain way. ### --feedback-- It means the outcome or result that comes from setting the options in a particular manner. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 16.98, + "finishTimestamp": 26.04 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 5.66, + "dialogue": { + "text": "Next, you should look for any examples that demonstrate how to use these parameters in practice.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 6.24, + "finishTime": 10.06, + "dialogue": { + "text": "Examples can show you how to set options correctly and what effect they have on the code.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 10.56 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001cac957f0740252c2611.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001cac957f0740252c2611.md index e83c21ccf59..b8c479aaa92 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001cac957f0740252c2611.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001cac957f0740252c2611.md @@ -5,14 +5,11 @@ challengeType: 19 dashedName: task-34 --- - + # --description-- -Answer the question below. +Listen to the audio and answer the question. # --question-- @@ -51,3 +48,60 @@ The focus is on demonstrating correct use and understanding effects of parameter ## --video-solution-- 1 + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Sarah", + "position": { + "x": 50, + "y": 0, + "z": 1.4 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 16.98, + "finishTimestamp": 26.04 + } + }, + "commands": [ + { + "character": "Sarah", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Sarah", + "startTime": 1, + "finishTime": 5.66, + "dialogue": { + "text": "Next, you should look for any examples that demonstrate how to use these parameters in practice.", + "align": "center" + } + }, + { + "character": "Sarah", + "startTime": 6.24, + "finishTime": 10.06, + "dialogue": { + "text": "Examples can show you how to set options correctly and what effect they have on the code.", + "align": "center" + } + }, + { + "character": "Sarah", + "opacity": 0, + "startTime": 10.56 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d1ffd0e0b40a8cbf0c7.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d1ffd0e0b40a8cbf0c7.md index eb1af1d34b7..a1262247e46 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d1ffd0e0b40a8cbf0c7.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d1ffd0e0b40a8cbf0c7.md @@ -5,10 +5,7 @@ challengeType: 22 dashedName: task-35 --- - + # --description-- @@ -45,3 +42,60 @@ This word means to find one's way through it. Tom is saying that Sarah's advice ### --feedback-- It means suggestions or advice. Tom plans to follow the advice Sarah gave him. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Tom", + "position": { + "x": 50, + "y": 15, + "z": 1.2 + }, + "opacity": 0 + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1, + "startTimestamp": 26.26, + "finishTimestamp": 31.52 + } + }, + "commands": [ + { + "character": "Tom", + "opacity": 1, + "startTime": 0 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 4.78, + "dialogue": { + "text": "Thank you. Your guidance is helping me navigate the documentation better.", + "align": "center" + } + }, + { + "character": "Tom", + "startTime": 5.06, + "finishTime": 6.26, + "dialogue": { + "text": "I'll follow your recommendations.", + "align": "center" + } + }, + { + "character": "Tom", + "opacity": 0, + "startTime": 6.76 + } + ] +} +``` diff --git a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d8b878f5141214f2d77.md b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d8b878f5141214f2d77.md index 9af75fa2da1..f43529e2070 100644 --- a/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d8b878f5141214f2d77.md +++ b/curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d8b878f5141214f2d77.md @@ -5,14 +5,11 @@ challengeType: 22 dashedName: task-36 --- - + # --description-- -This task involves summarizing the conversation between Tom and Sarah about understanding parameters and options in documentation. +Listen to the audio and complete the sentence. # --fillInTheBlank-- @@ -91,3 +88,131 @@ It means to find one's way through something. Tom finds Sarah's advice helpful i ### --feedback-- It means pieces of advice. Tom plans to follow the advice Sarah has given. + +# --scene-- + +```json +{ + "setup": { + "background": "company2-center.png", + "characters": [ + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 } + } + ], + "audio": { + "filename": "7.2-3.mp3", + "startTime": 1 + }, + "alwaysShowDialogue": true + }, + "commands": [ + { + "character": "Tom", + "position": { "x": 25, "y": 0, "z": 1 }, + "startTime": 0 + }, + { + "character": "Sarah", + "position": { "x": 70, "y": 0, "z": 1 }, + "startTime": 0.5 + }, + { + "character": "Tom", + "startTime": 1, + "finishTime": 5.72, + "dialogue": { + "text": "I sometimes get confused with the parameters and options listed in the documentation.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 6.04, + "finishTime": 7.76, + "dialogue": { + "text": "What should I do to understand them better?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 8.52, + "finishTime": 10.5, + "dialogue": { + "text": "You should begin by reading their descriptions.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 10.74, + "finishTime": 14.84, + "dialogue": { + "text": "The documentation can provide details on what each parameter does and how to use it.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 15.2, + "finishTime": 17.58, + "dialogue": { + "text": "I'll keep that in mind. What should I do next?", + "align": "left" + } + }, + { + "character": "Sarah", + "startTime": 18.18, + "finishTime": 22.64, + "dialogue": { + "text": "Next, you should look for any examples that demonstrate how to use these parameters in practice.", + "align": "right" + } + }, + { + "character": "Sarah", + "startTime": 23.22, + "finishTime": 27.04, + "dialogue": { + "text": "Examples can show you how to set options correctly and what effect they have on the code.", + "align": "right" + } + }, + { + "character": "Tom", + "startTime": 27.46, + "finishTime": 30.84, + "dialogue": { + "text": "Thank you. Your guidance is helping me navigate the documentation better.", + "align": "left" + } + }, + { + "character": "Tom", + "startTime": 31.12, + "finishTime": 32.32, + "dialogue": { + "text": "I'll follow your recommendations.", + "align": "left" + } + }, + { + "character": "Sarah", + "position": { "x": 125, "y": 0, "z": 1 }, + "startTime": 32.82 + }, + { + "character": "Tom", + "position": { "x": -25, "y": 0, "z": 1 }, + "startTime": 33.32 + } + ] +} +```