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.9 KiB
36 lines
2.9 KiB
<!--
|
|
CO_OP_TRANSLATOR_METADATA:
|
|
{
|
|
"original_hash": "c162b3b3a1cafc1483c8015e9b266f0d",
|
|
"translation_date": "2025-10-22T23:38:25+00:00",
|
|
"source_file": "6-space-game/3-moving-elements-around/assignment.md",
|
|
"language_code": "it"
|
|
}
|
|
-->
|
|
# Commenta il Tuo Codice
|
|
|
|
## Istruzioni
|
|
|
|
Un codice pulito e ben documentato è essenziale per mantenere e condividere i tuoi progetti. In questo compito, praticherai una delle abitudini più importanti per gli sviluppatori professionisti: scrivere commenti chiari e utili che spieghino lo scopo e la funzionalità del tuo codice.
|
|
|
|
Esamina il tuo file `app.js` nella cartella del tuo gioco e trova modi per commentarlo e sistemarlo. È molto facile che il codice diventi disordinato, e ora è un'ottima occasione per aggiungere commenti per assicurarti di avere un codice leggibile che potrai utilizzare in futuro.
|
|
|
|
**Il tuo compito include:**
|
|
- **Aggiungere commenti** che spieghino cosa fa ogni sezione principale del codice
|
|
- **Documentare le funzioni** con descrizioni chiare del loro scopo e dei loro parametri
|
|
- **Organizzare il codice** in blocchi logici con intestazioni di sezione
|
|
- **Rimuovere** qualsiasi codice inutilizzato o ridondante
|
|
- **Usare convenzioni** di denominazione coerenti per variabili e funzioni
|
|
|
|
## Griglia di Valutazione
|
|
|
|
| Criteri | Esemplare | Adeguato | Da Migliorare |
|
|
| -------- | --------- | -------- | ------------- |
|
|
| **Documentazione del Codice** | Il codice di `app.js` è completamente commentato con spiegazioni chiare e utili per tutte le sezioni principali e le funzioni | Il codice di `app.js` è adeguatamente commentato con spiegazioni di base per la maggior parte delle sezioni | Il codice di `app.js` ha pochi commenti e manca di spiegazioni chiare |
|
|
| **Organizzazione del Codice** | Il codice è organizzato in blocchi logici con intestazioni di sezione chiare e una struttura coerente | Il codice ha una certa organizzazione con raggruppamenti di base delle funzionalità correlate | Il codice è piuttosto disorganizzato e difficile da seguire |
|
|
| **Qualità del Codice** | Tutte le variabili e le funzioni usano nomi descrittivi, non c'è codice inutilizzato, segue convenzioni coerenti | La maggior parte del codice segue buone pratiche di denominazione con codice inutilizzato minimo | I nomi delle variabili non sono chiari, contiene codice inutilizzato, stile incoerente |
|
|
|
|
---
|
|
|
|
**Disclaimer**:
|
|
Questo documento è stato tradotto utilizzando il servizio di traduzione AI [Co-op Translator](https://github.com/Azure/co-op-translator). Sebbene ci impegniamo per garantire l'accuratezza, si prega di notare che le traduzioni automatiche possono contenere errori o imprecisioni. Il documento originale nella sua lingua nativa dovrebbe essere considerato la fonte autorevole. Per informazioni critiche, si raccomanda una traduzione professionale umana. Non siamo responsabili per eventuali incomprensioni o interpretazioni errate derivanti dall'uso di questa traduzione. |