You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
36 lines
2.8 KiB
36 lines
2.8 KiB
<!--
|
|
CO_OP_TRANSLATOR_METADATA:
|
|
{
|
|
"original_hash": "c162b3b3a1cafc1483c8015e9b266f0d",
|
|
"translation_date": "2025-10-22T23:14:14+00:00",
|
|
"source_file": "6-space-game/3-moving-elements-around/assignment.md",
|
|
"language_code": "br"
|
|
}
|
|
-->
|
|
# Comente Seu Código
|
|
|
|
## Instruções
|
|
|
|
Código limpo e bem documentado é essencial para manter e compartilhar seus projetos. Nesta tarefa, você praticará um dos hábitos mais importantes dos desenvolvedores profissionais: escrever comentários claros e úteis que expliquem o propósito e a funcionalidade do seu código.
|
|
|
|
Revise o arquivo `app.js` na pasta do seu jogo e encontre maneiras de comentá-lo e organizá-lo. É muito fácil o código sair do controle, e agora é uma boa oportunidade para adicionar comentários e garantir que você tenha um código legível para usar mais tarde.
|
|
|
|
**Sua tarefa inclui:**
|
|
- **Adicionar comentários** explicando o que cada seção principal do código faz
|
|
- **Documentar funções** com descrições claras de seu propósito e parâmetros
|
|
- **Organizar o código** em blocos lógicos com cabeçalhos de seção
|
|
- **Remover** qualquer código não utilizado ou redundante
|
|
- **Usar convenções** consistentes de nomenclatura para variáveis e funções
|
|
|
|
## Rubrica
|
|
|
|
| Critério | Exemplar | Adequado | Precisa Melhorar |
|
|
| -------- | --------- | -------- | ---------------- |
|
|
| **Documentação do Código** | O código `app.js` está totalmente comentado com explicações claras e úteis para todas as seções e funções principais | O código `app.js` está adequadamente comentado com explicações básicas para a maioria das seções | O código `app.js` tem poucos comentários e carece de explicações claras |
|
|
| **Organização do Código** | O código está organizado em blocos lógicos com cabeçalhos de seção claros e estrutura consistente | O código tem alguma organização com agrupamento básico de funcionalidades relacionadas | O código está um pouco desorganizado e difícil de seguir |
|
|
| **Qualidade do Código** | Todas as variáveis e funções usam nomes descritivos, sem código não utilizado, segue convenções consistentes | A maior parte do código segue boas práticas de nomenclatura com pouco código não utilizado | Os nomes das variáveis são pouco claros, contém código não utilizado, estilo inconsistente |
|
|
|
|
---
|
|
|
|
**Aviso Legal**:
|
|
Este documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução. |