opensource/freeCodeCamp
3
0
Fork 0
mirror of https://github.com/freeCodeCamp/freeCodeCamp.git synced 2026-09-24 23:01:18 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat(curriculum): add animations to block 7.2 of the English Curriculum (#55128)

Browse Source 
Co-authored-by: DanielRosa74 <58576743+DanielRosa74@users.noreply.github.com>
This commit is contained in:
miyaliu666
2024-06-17 18:31:16 -05:00
committed by GitHub
co-authored by DanielRosa74
parent df2d52a697
commit 6a822464fd
37 changed files with 2504 additions and 164 deletions
Download Patch File Download Diff File Expand all files Collapse all files
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd595245455d0dca3434ba.md
+138 -1
View File
@@ -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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5a9680a9540e9787dec5.md
+58 -4
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-1
---
<!--
AUDIO REFERENCE:
Tom: I'm trying to understand the code documentation, but it's quite overwhelming. What should I do to navigate it more effectively?
-->
<!-- (Audio) Tom: I'm trying to understand the code documentation, but it's quite overwhelming. What should I do to navigate it more effectively? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5c89285ea50f25bd0241.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-2
---
<!--
AUDIO REFERENCE:
Tom: I'm trying to understand the code documentation, but it's quite overwhelming. What should I do to navigate it more effectively?
-->
<!-- (Audio) Tom: I'm trying to understand the code documentation, but it's quite overwhelming. What should I do to navigate it more effectively? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5d1a6cb7f10f77a06163.md
+59 -5
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-3
---
<!--
AUDIO REFERENCE:
Sarah: Don't worry. When you're faced with extensive documentation, the first thing you should do is check for a table of contents or an index.
-->
<!-- (Audio) Sarah: Don't worry. When you're faced with extensive documentation, the first thing you should do is check for a table of contents or an index. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5da902959d0fda781aa3.md
+62 -1
View File
@@ -5,17 +5,21 @@ challengeType: 22
dashedName: task-4
---
<!-- (Audio) Sarah: Don't worry. When you're faced with extensive documentation, the first thing you should do is check for a table of contents or an index. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5dfc174596101eae1107.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-5
---
<!--
AUDIO REFERENCE:
Sarah: Don't worry. When you're faced with extensive documentation, the first thing you should do is check for a table of contents or an index.
-->
<!-- (Audio) Sarah: Don't worry. When you're faced with extensive documentation, the first thing you should do is check for a table of contents or an index. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f2abfdbc510942d76f8.md
+68 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-6
---
<!--
AUDIO REFERENCE:
Sarah: Don't worry. When you're faced with extensive documentation, the first thing you should do is check for a table of contents or an index. It can help you find the specific information you're looking for.
-->
<!-- (Audio) Sarah: Don't worry. When you're faced with extensive documentation, the first thing you should do is check for a table of contents or an index. It can help you find the specific information you're looking for. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fd5f86457b4910e35b51c9.md
+51 -6
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-7
---
<!--
AUDIO REFERENCE:
Tom: Okay, that makes sense. And what should I do next?
-->
<!-- (Audio) Tom: Okay, that makes sense. And what should I do next? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa914bc44081a196fa6f7.md
+1 -1
View File
@@ -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--
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65ffa9d80e7ffb1ab9b4df1c.md
+50 -5
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-11
---
<!--
AUDIO REFERENCE:
Sarah: 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.
-->
<!-- (Audio) Sarah: 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. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff2b49779301d9bdab6fa.md
+50 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-12
---
<!--
AUDIO REFERENCE:
Sarah: 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.
-->
<!-- (Audio) Sarah: 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. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff336d7553c1df86f7968.md
+49 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-13
---
<!--
AUDIO REFERENCE:
Sarah: Then, you can skim through and focus on the parts relevant to your current task.
-->
<!-- (Audio) Sarah: Then, you can skim through and focus on the parts relevant to your current task. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff428290eaa1e5819c119.md
+49 -4
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-14
---
<!--
AUDIO REFERENCE:
Tom: Thanks. I'll go over the documentation as you said.
-->
<!-- (Audio) Tom: Thanks. I'll go over the documentation as you said. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/65fff57ce568cf1ed9702fbf.md
+140 -6
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-15
---
<!--
AUDIO REFERENCE:
Entire dialogue
-->
<!-- (Audio) The whole dialogue -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000a440c2f492ddee509f9.md
+129 -1
View File
@@ -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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000ac46e87f52e84328b95.md
+59 -5
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-16
---
<!--
AUDIO REFERENCE:
Tom: I often find function descriptions in the documentation, but I'm not sure how to interpret them. What should I focus on when reading these?
-->
<!-- (Audio) Tom: I often find function descriptions in the documentation, but I'm not sure how to interpret them. What should I focus on when I'm reading these? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000eeeec06b6338a5c5caf.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-17
---
<!--
AUDIO REFERENCE:
Tom: I often find function descriptions in the documentation, but I'm not sure how to interpret them. What should I focus on when reading these?
-->
<!-- (Audio) Tom: I often find function descriptions in the documentation, but I'm not sure how to interpret them. What should I focus on when reading these? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000f74c71b623407a8394e.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-18
---
<!--
AUDIO REFERENCE:
Tom: I often find function descriptions in the documentation, but I'm not sure how to interpret them. What should I focus on when reading these?
-->
<!-- (Audio) Tom: I often find function descriptions in the documentation, but I'm not sure how to interpret them. What should I focus on when reading these? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66000fec4b5a8c348421fada.md
+60 -6
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-19
---
<!--
AUDIO REFERENCE:
Sarah: That's a great question. First, you should pay attention to the function's name and parameters.
-->
<!-- (Audio) Sarah: That's a great question. First, you should pay attention to the function's name and parameters. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600107b9dffa8350e0c4ee8.md
+68 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-20
---
<!--
AUDIO REFERENCE:
Sarah: That's a great question. First, you should pay attention to the function's name and parameters. It can give you an idea of what the function does and how to use it.
-->
<!-- (Audio) Sarah: That's a great question. First, you should pay attention to the function's name and parameters. It can give you an idea of what the function does and how to use it. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011289b5237359f69c76b.md
+50 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-21
---
<!--
AUDIO REFERENCE:
Tom: Got it. Is there anything else I should keep in mind?
-->
<!-- (Audio) Tom: Got it. Is there anything else I should keep in mind? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660011d015f7d43626524ef8.md
+49 -4
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-22
---
<!--
AUDIO REFERENCE:
Sarah: Absolutely. You should look for a description of what the function does and any return values.
-->
<!-- (Audio) Sarah: Absolutely. You should look for a description of what the function does and any return values. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012a18576e836ea18fa0b.md
+50 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-23
---
<!--
AUDIO REFERENCE:
Sarah: Absolutely. You should look for a description of what the function does and any return values.
-->
<!-- (Audio) Sarah: Absolutely. You should look for a description of what the function does and any return values. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660012ff748bf2375c31b591.md
+58 -4
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-24
---
<!--
AUDIO REFERENCE:
Sarah: Also, check for any examples or code snippets. They can help illustrate how to use the function effectively.
-->
<!-- (Audio) Sarah: Also, check for any examples or code snippets. They can help illustrate how to use the function effectively. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660013ce54713f37ecac079d.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-25
---
<!--
AUDIO REFERENCE:
Sarah: Also, check for any examples or code snippets. They can help illustrate how to use the function effectively.
-->
<!-- (Audio) Sarah: Also, check for any examples or code snippets. They can help illustrate how to use the function effectively. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/6600144958b1d33857b0309f.md
+49 -4
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-26
---
<!--
AUDIO REFERENCE:
Tom: Great tips. Thanks a lot.
-->
<!-- (Audio) Tom: Great tips. Thanks a lot. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660014d3f5b02038de6ac35c.md
+132 -7
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-27
---
<!--
AUDIO REFERENCE:
Entire dialogue
-->
<!-- (Audio) The whole dialogue -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/660019617debd03c767e0a3d.md
+129 -1
View File
@@ -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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001985c091f13cda6d4f4d.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-28
---
<!--
AUDIO REFERENCE:
Tom: I sometimes get confused with the parameters and options listed in the documentation. What should I do to understand them better?
-->
<!-- (Audio) Tom: I sometimes get confused with the parameters and options listed in the documentation. What should I do to understand them better? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a1c9df0a83d8e8c670a.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-29
---
<!--
AUDIO REFERENCE:
Tom: I sometimes get confused with the parameters and options listed in the documentation. What should I do to understand them better?
-->
<!-- (Audio) Tom: I sometimes get confused with the parameters and options listed in the documentation. What should I do to understand them better? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001a935988e43e1183bd38.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-30
---
<!--
AUDIO REFERENCE:
Sarah: You should begin by reading their descriptions. The documentation can provide details on what each parameter does and how to use it.
-->
<!-- (Audio) Sarah: You should begin by reading their descriptions. The documentation can provide details on what each parameter does and how to use it. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b1aa59adc3ea4b024b4.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-31
---
<!--
AUDIO REFERENCE:
Sarah: You should begin by reading their descriptions. The documentation can provide details on what each parameter does and how to use it.
-->
<!-- (Audio) Sarah: You should begin by reading their descriptions. The documentation can provide details on what each parameter does and how to use it. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001b8d0518d03f18b19715.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-32
---
<!--
AUDIO REFERENCE:
Tom: I'll keep that in mind. What should I do next?
-->
<!-- (Audio) Tom: I'll keep that in mind. What should I do next? -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001be61f20a33f8a45f3cb.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-33
---
<!--
AUDIO REFERENCE:
Sarah: Next, you should look for any examples that demonstrate how to use these parameters in practice. Examples can show you how to set options correctly and what effect they have on the code.
-->
<!-- (Audio) Sarah: Next, you should look for any examples that demonstrate how to use these parameters in practice. Examples can show you how to set options correctly and what effect they have on the code. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001cac957f0740252c2611.md
+59 -5
View File
@@ -5,14 +5,11 @@ challengeType: 19
dashedName: task-34
---
<!--
AUDIO REFERENCE:
Sarah: Next, you should look for any examples that demonstrate how to use these parameters in practice. Examples can show you how to set options correctly and what effect they have on the code.
-->
<!-- (Audio) Sarah: Next, you should look for any examples that demonstrate how to use these parameters in practice. Examples can show you how to set options correctly and what effect they have on the code. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d1ffd0e0b40a8cbf0c7.md
+58 -4
View File
@@ -5,10 +5,7 @@ challengeType: 22
dashedName: task-35
---
<!--
AUDIO REFERENCE:
Tom: Thank you. Your guidance is helping me navigate this documentation better. I'll follow your recommendations.
-->
<!-- (Audio) Tom: Thank you. Your guidance is helping me navigate this documentation better. I'll follow your recommendations. -->
# --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
}
]
}
```
curriculum/challenges/english/21-a2-english-for-developers/learn-how-to-read-and-understand-code-documentation/66001d8b878f5141214f2d77.md
+130 -5
View File
@@ -5,14 +5,11 @@ challengeType: 22
dashedName: task-36
---
<!--
AUDIO REFERENCE:
Entire dialogue
-->
<!-- (Audio) The whole dialogue -->
# --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
}
]
}
```