204 lines
5.1 KiB
Markdown
204 lines
5.1 KiB
Markdown
# Como ajudar com desafios em vídeo
|
|
|
|
Os desafios em vídeo são um novo tipo de desafio no currículo freeCodeCamp.
|
|
|
|
Um desafio em vídeo é uma seção de um curso completo sobre um determinado tópico. Uma página de desafio em vídeo incorpora um vídeo do YouTube. Cada página de desafio tem uma única pergunta de múltipla escolha relacionada ao vídeo. O usuário deve responder a pergunta corretamente antes de avançar para o próximo desafio em vídeo.
|
|
|
|
As páginas de desafio em vídeo são criadas por membros da equipe freeCodeCamp. Vídeos do YouTube também são enviados por membros da equipe freeCodeCamp. Muitos dos desafios em vídeo ainda não possuem perguntas associadas a eles.
|
|
|
|
Você pode ajudar criando questões de múltipla escolha e adicionando-as aos arquivos 'markdown' para os desafios em vídeo.
|
|
|
|
## Modelo de desafio
|
|
|
|
Abaixo está um modelo de arquivo markdown do desafio.
|
|
|
|
````md
|
|
---
|
|
id: Unique identifier (alphanumerical, MongoDB_id)
|
|
title: Challenge Title
|
|
challengeType: 11
|
|
videoId: 'YouTube videoId for video challenge'
|
|
forumTopicId: 12345
|
|
---
|
|
|
|
# --description--
|
|
|
|
Challenge description text, in markdown
|
|
|
|
```html
|
|
<div>example code</div>
|
|
````
|
|
|
|
# --question--
|
|
|
|
Esses espaços são normalmente utilizados para questões de múltipla escolha dos desafios de Python.
|
|
|
|
## --text--
|
|
|
|
O texto da questão vêm aqui.
|
|
|
|
## --answers--
|
|
|
|
Resposta 1
|
|
|
|
---
|
|
|
|
Resposta 2
|
|
|
|
---
|
|
|
|
Mais respostas
|
|
|
|
## --video-solution--
|
|
|
|
O número da resposta correta fica aqui.
|
|
````
|
|
|
|
## Criando perguntas para desafios em video
|
|
|
|
### Acessar o arquivo markdown do desafio em vídeo
|
|
|
|
Os arquivos markdown dos desafios estão localizadas no currículo em:
|
|
|
|
- [Data Analysis with Python Course](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/curriculum/challenges/english/08-data-analysis-with-python/data-analysis-with-python-course)
|
|
- [TensorFlow 2.0 Course](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/curriculum/challenges/english/11-machine-learning-with-python/tensorflow)
|
|
- [Numpy Course](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/curriculum/challenges/english/08-data-analysis-with-python/numpy)
|
|
- [How Neural Networks Work Course](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/curriculum/challenges/english/11-machine-learning-with-python/how-neural-networks-work)
|
|
|
|
Escolha um arquivo dentre as opções acima.
|
|
|
|
### Explore o vídeo associado ao desafio e crie uma questão de múltipla escolha
|
|
|
|
Primeiro, localize o videoId.
|
|
|
|
Por exemplo, no código a seguir a partir do cabeçalho de um arquivo markdown de desafio de vídeo, o videoId é "nVAaxZ34khk". No GitHub, a informação deve estar contida em formato tabular.
|
|
|
|
````
|
|
---
|
|
id: 5e9a093a74c4063ca6f7c14d title: Data Analysis Example A challengeType: 11
|
|
videoId: nVAaxZ34khk
|
|
---
|
|
```
|
|
|
|
Em seguida, acesse o vídeo no YouTube correspondente com aquele `videoId`. The URL for the video will be:
|
|
https://www.youtube.com/watch?v=[videoId] (replace `videoId` in the URL with the video's ID - without square brackets)
|
|
|
|
In the example above, the URL is https://www.youtube.com/watch?v=nVAaxZ34khk
|
|
|
|
Skim the YouTube video with that videoId and think of a multiple-choice question based on the content of the video.
|
|
|
|
### Adicione a pergunta ao arquivo markdown
|
|
|
|
Você pode adicionar a pergunta localmente ou utilizando a interface do Github. Para adicionar a pergunta localmente, você precisa [configurar o freeCodeCamp localmente](how-to-setup-freecodecamp-locally.md). Você também pode encontrar o arquivo no GitHub e clicar no botão editar para adicionar a pergunta diretamente em seu navegador.
|
|
|
|
Se uma pergunta não tiver sido adicionada a um desafio de vídeo ainda, ela terá a seguinte forma padrão:
|
|
|
|
```md
|
|
# --question-
|
|
|
|
## --text--
|
|
|
|
Texto da questão
|
|
|
|
## --answers--
|
|
|
|
Resposta 1
|
|
|
|
---
|
|
|
|
Resposta 2
|
|
|
|
---
|
|
|
|
Mais respostas
|
|
|
|
## --video-solution--
|
|
|
|
1
|
|
```
|
|
|
|
Add/Update the question text under the part that shows:
|
|
|
|
```
|
|
# --question--
|
|
|
|
## --text--
|
|
```
|
|
|
|
Adicione/Atualize (`Answer 1`, `Answer 2`, e assim por diante) sob `## --answers--`. Confirme se o número sob `## --video-solution--` seja o número da resposta correta. Você pode adicionar mais respostas possíveis usando o mesmo formato. Tanto a pergunta quanto as respostas podem estar entre aspas.
|
|
|
|
### Exemplos de perguntas
|
|
|
|
````md
|
|
# --question--
|
|
|
|
## --text--
|
|
|
|
What does this JavaScript code log to the console?
|
|
|
|
```js
|
|
console.log('hello world');
|
|
````
|
|
|
|
## --answers--
|
|
|
|
hello _world_
|
|
|
|
---
|
|
|
|
**hello** world
|
|
|
|
---
|
|
|
|
hello world
|
|
|
|
---
|
|
|
|
## --video-solution--
|
|
|
|
3
|
|
````
|
|
|
|
````md
|
|
# --question--
|
|
|
|
## --text--
|
|
|
|
What will print out after running this code:
|
|
|
|
```py
|
|
width = 15
|
|
height = 12.0
|
|
print(height/3)
|
|
````
|
|
|
|
## --answers--
|
|
|
|
39
|
|
|
|
---
|
|
|
|
4
|
|
|
|
---
|
|
|
|
4.0
|
|
|
|
---
|
|
|
|
5.0
|
|
|
|
---
|
|
|
|
5
|
|
|
|
## --video-solution--
|
|
|
|
3 ````
|
|
|
|
Para mais exemplos, você pode ver os arquivos markdown para o seguinte curso em vídeo. Todos os desafios já possuem perguntas: [Python for Everybody Course](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/curriculum/challenges/english/07-scientific-computing-with-python/python-for-everybody)
|
|
|
|
## Abra um pull request
|
|
|
|
Depois de criar uma ou mais perguntas, você pode confirmar as mudanças em uma nova branch e [abrir um pull request](how-to-open-a-pull-request.md).
|