November 18
La documentazione è una delle cose più importanti che si possono aggiungere durante la scrittura di codice di programmazione. Documentare il programma con l'aggiunta di commenti al codice aiuterà gli altri a capire che cosa si suppone che ogni sezione di codice per realizzare all'interno del vostro programma. Anche se si sta scrivendo il codice che nessuno leggerà, i commenti possono aiutare a ricordare quello che stavi facendo quando si guarda un programma che hai scritto mesi o anni in passato. Ci sono due metodi di inserimento dei commenti nel vostro programma Java.
1 Aprite il vostro editor di testo. Inserisci due caratteri di barra avanti all'inizio di una riga di testo.
2 Inserisci il tuo commento subito dopo i due slash. Il commento dovrebbe essere simile a questo:
// Questo è un esempio di una singola riga di commento.
3 Terminare il commento premendo il tasto Invio sulla tastiera. Il tasto invio terminerà automaticamente il commento. L'esecuzione di codice riprenderà nella riga successiva.
4 Inserire una barra seguita da un asterisco.
5 Inserisci il tuo commento ovunque dopo l'asterisco.
6 Alla fine del tuo commento, immettere un asterisco, seguito da un carattere barra. Il tuo commento sarà simile a questa:
/ *
Questo è un commento che
si estende su più righe.
Questo commento può essere lungo quanto si
vorrebbe farlo.
* /